DescribeClientCertificateStatusForSerialNumber - DescribeClientCertificateStatusForSerialNumber

通过证书的序列号查询客户端证书和服务端证书的状态信息。

接口说明

使用说明

本接口用于通过证书的序列号,批量查询客户端证书或服务端证书的状态,例如,证书是否已被吊销。

QPS 限制

本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用将会被限流,这可能影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

SerialNumber

string

要查询的客户端证书或服务端证书的序列号。多个证书序列号之间使用半角逗号(,)分隔。

说明

您可以调用 ListClientCertificate 查询所有客户端与服务端证书的序列号。

b67e53ebcea9b77d65b0c3236646d715****

调用 API 时,除了本文中该 API 的请求参数,还需加入阿里云 API 公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用 API 的请求格式,请参见本文示例中的请求示例。

返回参数

名称

类型

描述

示例值

object

RequestId

string

本次请求的 ID。

15C66C7B-671A-4297-9187-2C4477247A74

CertificateStatus

array<object>

证书状态的详细信息。

object

SerialNumber

string

证书的序列号。

b67e53ebcea9b77d65b0c3236646d715****

Status

string

证书的当前状态。取值:

  • good:表示该证书未被吊销。

  • revoked:表示该证书已被吊销。

  • unknown:表示服务器不能判断该证书的状态。

good

RevokeTime

integer

证书被吊销的日期。

说明

只有当 Statusrevoked(表示证书已被吊销)时,才会返回该参数。

2021-01-01T00:00

示例

正常返回示例

JSON格式

{
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "CertificateStatus": [
    {
      "SerialNumber": "b67e53ebcea9b77d65b0c3236646d715****",
      "Status": "good",
      "RevokeTime": 0
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情