全部产品
Search

搜索本产品

    数字证书管理服务：ListRevokeCertificate - 查询吊销证书列表

    文档中心

    数字证书管理服务：ListRevokeCertificate - 查询吊销证书列表

    更新时间：Sep 20, 2024

    查询所有已被吊销的客户端证书和服务端证书的详细信息。

    接口说明

    本接口用于分页查询所有已被吊销的客户端证书和服务端证书的详细信息，例如，证书的唯一识别码、序列号、吊销日期等。

    QPS 限制

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

    调试

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

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    yundun-cert:ListRevokeCertificatelist
    • 全部资源
      *
      无
    		无

    请求参数

    名称类型必填描述示例值
    CurrentPageinteger否

    分页查询时，设置当前页面的页码。默认值为 1。

    		1
    ShowSizeinteger否

    分页查询时，设置每页包含已被吊销证书的数量。默认值为 20。

    		20

    调用 API 时，除了本文中该 API 的请求参数，还需加入阿里云 API 公共请求参数。

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

    返回参数

    名称类型描述示例值
    object

    ListCertificateResponse2。

    CertificateListarray<object>

    已被吊销的客户端证书或服务端证书的详细信息。

    object

    对象。

    RevokeDatestring

    证书被吊销的日期。格式为yyyy-MM-ddT00:00Z，例如，2021-09-01T00:00Z表示 2021 年 09 月 01 日。

    		2021-09-01T00:00Z
    Identifierstring

    证书的唯一识别码。

    		05e148d8d3ecc9976d9ecd2b2f25****
    SerialNumberstring

    证书的序列号。

    		168b12c42e62339f8d2340ff530f9365****
    SubjectDNstring

    证书的 DN（Distinguished Name）属性，表示证书的使用者，具体包含以下信息：

    • C：国家。

    • O：组织机构。

    • OU：部门。

    • L：城市。

    • ST：省份或州。

    • CN：公用名。

    		C=CN,O=阿里云计算有限公司,OU=Security,L=ZheJiang,ST=HangZhou,CN=aliyundoc.com
    CommonNamestring

    证书的公用名。

    		aliyundoc.com
    OrganizationUnitstring

    签发该证书的子 CA 证书关联的组织机构下部门的名称。

    		Security
    Organizationstring

    签发该证书的子 CA 证书关联的组织机构的名称。

    		阿里云计算有限公司
    Localitystring

    签发该证书的子 CA 证书关联的组织机构所在城市的名称。

    		Hangzhou
    Statestring

    签发该证书的子 CA 证书关联的组织机构所在省份或州的名称。

    		Zhejiang
    CountryCodestring

    签发该证书的子 CA 证书关联的组织机构所在国家的代码。

    关于不同国家代码的含义，请参见管理公司信息中的国际代号章节。

    		CN
    Sansstring

    证书的 SAN（Subject Alternative Name）扩展属性。

    该参数使用 JSON 数组转化的字符串表示。JSON 数组中的每个元素是一个结构体，对应一个 SAN 扩展。每个 SAN 扩展结构体包含以下参数：

    • Type：Integer 类型，表示扩展的类型。取值：
      • 1：表示邮箱地址。
      • 2：表示域名。
      • 6：表示统一资源标识符 URI（Uniform Resource Identifier）。
      • 7：表示 IP 地址。
    • Value：String 类型，表示扩展的内容。
    		[ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]
    Statusstring

    状态。

    		ISSUE
    BeforeDatestring

    证书的签发日期。格式为yyyy-MM-ddT00:00Z，例如，2021-01-01T00:00Z表示 2021 年 01 月 01 日。

    		2021-01-01T00:00Z
    AfterDatestring

    证书的到期日期。格式为yyyy-MM-ddT00:00Z，例如，2021-12-31T00:00Z表示 2021 年 12 月 31 日。

    		2021-12-31T00:00Z
    Algorithmstring

    证书的加密算法类型。取值：

    • RSA：表示 RSA 算法。
    • ECC：表示 ECC 算法。
    • SM2：表示 SM2（国密）算法。
    		RSA
    KeySizeinteger

    证书的密钥长度。

    		4096
    SignAlgorithmstring

    证书的签名算法。

    		SHA256WITHRSA
    CertificateTypestring

    证书类型。

    		SERVER
    ParentIdentifierstring

    父证书标识。

    		160ae6bb538d538c70c01f81dcf2****
    Sha2string

    证书的 SHA256 数字指纹。

    		b60eff7e04323ff662f9ab5e6986f849f626a9c7bf2c59dcc752fa23779a****
    Md5string

    证书的 MD5 数字指纹。

    		05e148d8d3ecc9976d9ecd2b2f25****
    CurrentPageinteger

    当前页面的页码。

    		1
    PageCountinteger

    总页数。

    		1
    ShowSizeinteger

    每页包含已被吊销证书的数量。

    		20
    TotalCountlong

    已被吊销的客户端证书和服务端证书的总数。

    		1
    RequestIdstring

    本次请求的 ID。

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

    示例

    正常返回示例

    JSON格式

    {
  "CertificateList": [
    {
      "RevokeDate": "2021-09-01T00:00Z",
      "Identifier": "05e148d8d3ecc9976d9ecd2b2f25****",
      "SerialNumber": "168b12c42e62339f8d2340ff530f9365****",
      "SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=ZheJiang,ST=HangZhou,CN=aliyundoc.com",
      "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": "2021-01-01T00:00Z",
      "AfterDate": "2021-12-31T00:00Z",
      "Algorithm": "RSA",
      "KeySize": 4096,
      "SignAlgorithm": "SHA256WITHRSA",
      "CertificateType": "SERVER",
      "ParentIdentifier": "160ae6bb538d538c70c01f81dcf2****",
      "Sha2": "b60eff7e04323ff662f9ab5e6986f849f626a9c7bf2c59dcc752fa23779a****",
      "Md5": "05e148d8d3ecc9976d9ecd2b2f25****"
    }
  ],
  "CurrentPage": 1,
  "PageCount": 1,
  "ShowSize": 20,
  "TotalCount": 1,
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

    错误码

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

    变更历史

    变更时间变更内容概要操作
    2024-09-20OpenAPI 描述信息更新查看变更详情