ListCert - 查询CA签发的证书列表_数字证书管理服务（原SSL证书）(SSL Certificate)-阿里云帮助中心

获取证书列表。

接口说明

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

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cert:ListCert

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
InstanceUuid	string	否	实例的 uuid。	1ef79512-569b-6a4e-9105-9b91473562f7
BeforeDate	string	否	证书的修改时间。	2025-09-04
AfterDate	string	否	证书绑定的主机记录。	2024-05-13 12:59:45
Status	string	否	证书状态。取值： ISSUE：正常。 REVOKE：已吊销。	ISSUE
Type	string	否	证书类型。取值： SERVER：服务端证书。 CLIENT：客户端证书。 END_ENTITY：终端证书。	CLIENT
CurrentPage	integer	否	当前页的页码。	1
ShowSize	integer	否	证书的总大小。单位：字节。	50
MaxResults	integer	否	本次读取的最大数据量。	20
NextToken	string	否	下一个查询开始 Token，NextToken 为空说明没有下一个。	1d2db86sca4384811e0b5e8707e68181f

返回参数

名称	类型	描述	示例值
	object	OpenApiResponse<PagedResultData>
TotalCount	integer	证书总数。	10
PageCount	integer	页码数。	1
CurrentPage	integer	当前页码。	1
ShowSize	integer	证书的总大小。单位：字节。	50
List	array<object>	证书所属数据源 id。
	object	证书信息。
Status	string	证书状态。取值： ISSUE：正常。 REVOKE：已吊销。	complete
AfterDate	string	证书到期时间。	2024-05-13 12:59:45
Organization	string	证书组织。	test
KeyExportable	boolean	是否可以使用该证书。取值： true：可以使用。 false：不可以使用。
SubjectDn	string	订阅关系 id。	SubjectDn
Algorithm	string	算法类型。	RSA
CertificateType	string	证书类型。取值： free：免费证书。 cas：云盾证书。 upload：自定义上传。	Server
Identifier	string	证书标识。	1ef539a8-1e1f-6b88-8c11-21cf01a203e9
SerialNumber	string	证书序列号。	3a3ee3c3597d675e
Extra	string	扩展字段。	{"appId":"APP_PFHMIGUHKDUW6S3N7ZL2"}
OrganizationUnit	string	购买证书的用户所属的公司或组织名称。	IT
BeforeTime	integer	客户端证书的签发时间，使用时间戳格式，默认为您调用该接口的时间。单位：毫秒。说明 BeforeTime 和 AfterTime 参数必须同时为空或者同时设置。	1728921600000
AliasName	string	设置签发证书的名称。	test
AfterTime	integer	客户端证书的服务到期时间，使用时间戳格式。单位：毫秒。说明 BeforeTime 和 AfterTime 参数必须同时为空或者同时设置。	1728921600000
Id	string	证书订单所属数据源 ID。	1806958
Tags	array	证书标签。
	string	证书标签。	{"app-57074":"test"}
CommonName	string	证书绑定的主域名。	www.kfsjn.xyz
BeforeDate	string	证书签发时间。	2026-05-19
RequestId	string	请求 id。	15C66C7B-671A-4297-9187-2C4477247A74
NextToken	string	下一个查询开始 Token，NextToken 为空说明没有下一个。	1d2db86sca4384811e0b5e8707e68181f
MaxResults	integer	本次读取的最大数据量。	20

示例

正常返回示例

JSON格式

{
  "TotalCount": 10,
  "PageCount": 1,
  "CurrentPage": 1,
  "ShowSize": 50,
  "List": [
    {
      "Status": "complete",
      "AfterDate": "2024-05-13 12:59:45",
      "Organization": "test",
      "KeyExportable": true,
      "SubjectDn": "SubjectDn",
      "Algorithm": "RSA",
      "CertificateType": "Server",
      "Identifier": "1ef539a8-1e1f-6b88-8c11-21cf01a203e9",
      "SerialNumber": "3a3ee3c3597d675e",
      "Extra": "{\"appId\":\"APP_PFHMIGUHKDUW6S3N7ZL2\"}",
      "OrganizationUnit": "IT",
      "BeforeTime": 1728921600000,
      "AliasName": "test",
      "AfterTime": 1728921600000,
      "Id": "1806958",
      "Tags": [
        "{\"app-57074\":\"test\"}"
      ],
      "CommonName": "www.kfsjn.xyz",
      "BeforeDate": "2026-05-19"
    }
  ],
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "NextToken": "1d2db86sca4384811e0b5e8707e68181f",
  "MaxResults": 20
}

错误码

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

变更历史

更多信息，参考变更详情。