查询所有客户端证书和服务端证书的详细信息。
接口说明
本接口用于分页查询您已创建的所有客户端证书和服务端证书的详细信息,例如,证书的唯一识别码、序列号、使用者信息、内容、状态等。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用将会被限流,这可能影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-cert:ListClientCertificate |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CurrentPage |
integer |
否 |
分页查询时,设置当前页面的页码。默认值为 1。 |
1 |
| ShowSize |
integer |
否 |
分页查询时,设置每页显示证书的数量。默认值为 20。 |
20 |
| Identifier |
string |
否 |
要查询的客户端证书或服务端证书的唯一识别码。 说明
您可以调用 ListClientCertificate 查询所有客户端证书和服务端证书的唯一识别码。 |
160ae6bb538d538c70c01f81dcf2**** |
| ResourceGroupId |
string |
否 |
调用 API 时,除了本文中该 API 的请求参数,还需加入阿里云 API 公共请求参数。
调用 API 的请求格式,请参见本文示例中的请求示例。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
ListCertificateResponse2 |
||
| CertificateList |
array<object> |
客户端证书或服务端证书的详情列表。 |
|
|
object |
对象。 |
||
| X509Certificate |
string |
证书的内容。 |
-----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE----- |
| Identifier |
string |
证书的唯一识别码。 |
d3b95700998e47afc4d95f886579**** |
| SerialNumber |
string |
证书的序列号。 |
62b2b943a32d96883a6650e672ea0276**** |
| SubjectDN |
string |
证书的 DN(Distinguished Name)属性,表示证书的使用者,具体包含以下信息:
|
C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun |
| CommonName |
string |
证书的公用名。 |
aliyundoc.com |
| OrganizationUnit |
string |
签发该证书的子 CA 证书关联的组织机构下部门的名称。 |
Security |
| Organization |
string |
签发该证书的子 CA 证书关联的组织机构的名称。 |
阿里云计算有限公司 |
| Locality |
string |
签发该证书的子 CA 证书关联的组织机构所在城市的名称。 |
Hangzhou |
| State |
string |
签发该证书的子 CA 证书关联的组织机构所在省份、直辖市或自治区的名称。 |
Zhejiang |
| CountryCode |
string |
签发该证书的子 CA 证书关联的组织机构所在国家的代码。 关于不同国家代码的含义,请参见管理公司信息中的国际代号章节。 |
CN |
| Sans |
string |
证书的 SAN(Subject Alternative Name)扩展属性,表示证书关联的其他域名、IP 地址等。 该参数使用 JSON 数组转化的字符串表示。JSON 数组中的每个元素是一个结构体,对应一个 SAN 扩展。 每个 SAN 扩展结构体包含以下参数:
|
[ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ] |
| Status |
string |
证书的状态。取值:
|
ISSUE |
| BeforeDate |
integer |
证书的签发日期。使用时间戳表示,单位:毫秒。 |
1634283958000 |
| AfterDate |
integer |
证书的到期日期。使用时间戳表示,单位:毫秒。 |
1665819958000 |
| Algorithm |
string |
证书的加密算法类型。取值:
|
RSA |
| KeySize |
integer |
证书的密钥长度。 |
4096 |
| SignAlgorithm |
string |
证书的签名算法。 |
SHA256WITHRSA |
| CertificateType |
string |
证书的类型。取值:
|
SERVER |
| ParentIdentifier |
string |
签发该证书的子 CA 证书的唯一识别码。 |
160ae6bb538d538c70c01f81dcf2**** |
| Sha2 |
string |
证书的 SHA256 数字指纹。 |
14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9**** |
| Md5 |
string |
证书的 MD5 数字指纹。 |
d3b95700998e47afc4d95f886579**** |
| Days |
integer |
证书的有效期。单位:天。 |
365 |
| ResourceGroupId |
string |
||
| CurrentPage |
integer |
当前页面的页码。 |
1 |
| PageCount |
integer |
总页数。 |
1 |
| ShowSize |
integer |
每页显示证书的数量。 |
20 |
| TotalCount |
integer |
查询到的客户端证书和服务端证书的总数量。 |
1 |
| RequestId |
string |
本次请求的 ID。 |
15C66C7B-671A-4297-9187-2C4477247A74 |
示例
正常返回示例
JSON格式
{
"CertificateList": [
{
"X509Certificate": "-----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE-----",
"Identifier": "d3b95700998e47afc4d95f886579****",
"SerialNumber": "62b2b943a32d96883a6650e672ea0276****",
"SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
"CommonName": "aliyundoc.com",
"OrganizationUnit": "Security",
"Organization": "阿里云计算有限公司",
"Locality": "Hangzhou",
"State": "Zhejiang",
"CountryCode": "CN",
"Sans": "[ {\"Type\": 7, \"Value\": \"192.0.XX.XX\"}, {\"Type\": 2, \"Value\": \"www.aliyundoc.com\"}, ]",
"Status": "ISSUE",
"BeforeDate": 1634283958000,
"AfterDate": 1665819958000,
"Algorithm": "RSA",
"KeySize": 4096,
"SignAlgorithm": "SHA256WITHRSA",
"CertificateType": "SERVER",
"ParentIdentifier": "160ae6bb538d538c70c01f81dcf2****",
"Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
"Md5": "d3b95700998e47afc4d95f886579****",
"Days": 365,
"ResourceGroupId": ""
}
],
"CurrentPage": 1,
"PageCount": 1,
"ShowSize": 20,
"TotalCount": 1,
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。