ListClientCertificate - 查询证书列表

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

接口说明

本接口用于分页查询您已创建的所有客户端证书和服务端证书的详细信息,例如,证书的唯一识别码、序列号、使用者信息、内容、状态等。

QPS 限制

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

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

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:国家。

  • O:组织机构。

  • OU:部门。

  • L:城市。

  • ST:省份、直辖市或自治区。

  • CN:公用名。

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: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"}, ]

Status

string

证书的状态。取值:

  • ISSUE:表示正常签发。

  • REVOKE:表示已被吊销。

ISSUE

BeforeDate

integer

证书的签发日期。使用时间戳表示,单位:毫秒。

1634283958000

AfterDate

integer

证书的到期日期。使用时间戳表示,单位:毫秒。

1665819958000

Algorithm

string

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

  • RSA:表示 RSA 算法。

  • ECC:表示 ECC 算法。

  • SM2:表示 SM2(国密)算法。

RSA

KeySize

integer

证书的密钥长度。

4096

SignAlgorithm

string

证书的签名算法。

SHA256WITHRSA

CertificateType

string

证书的类型。取值:

  • CLIENT:表示客户端证书。

  • SERVER:表示服务端证书。

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"
}

错误码

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

变更历史

更多信息,参考变更详情