调用本接口查询代码签名证书实例列表。

请求说明

请求频率：同一个租户每秒最多允许请求20次。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Action string 必选示例值：CodeSignCertificateListInstances

要执行的操作，取值：CodeSignCertificateListInstances。

Version string 必选示例值：2024-10-01

API的版本，取值：2024-10-01。

Body

CertificateExpireAfter integer 可选示例值：2024-10-25 08:00:00

指定证书过期时间的开始时间。时间格式为：yyyy-mm-dd hh:mm:ss。

CertificateExpireBefore integer 可选示例值：2024-11-24 07:59:59

指定证书过期时间的结束时间。格式为：yyyy-mm-dd hh:mm:ss。

CommonName string 可选示例值：测试企业

组织名称。即证书申请时填写的公用名称（CN），通常为企业或组织的法定名称。

Id string 可选示例值：cert-310a6640e2ef4c1dbe5065c62821****

指定证书实例的ID。

Name string 可选示例值：测试企业

证书备注名称。

OrderStatus string[] 可选示例值：Issued

证书实例状态。支持取值：

NotSubmitted：未提交

Pending：待处理

Issued：已签发

Cancelling：取消中

Canceled：已取消

Revoking：吊销中

Revoked：已吊销

Failed：失败

Unknown：未知

PageNumber integer 必选示例值：1

设置要返回的页码，取值范围：>= 1。默认值：1。

PageSize integer 必选示例值：10

设置单页包含的最大证书实例数。默认值：10。最大值：100。

Project string 可选示例值：default

指定证书实例所属火山引擎项目的名称。

Type string 可选示例值：EV

证书级别。代码签名证书有以下取值：

OV（OV代码签名证书）

EV（EV代码签名证书）

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Data object[] 示例值：

证书实例列表。

Id string 示例值：cert-c88df6d4a1b348c3b714b746d3cc****

证书实例ID。

Name string 示例值：测试企业

证书备注名称。

Type string 示例值：EV

证书级别。代码签名证书有以下取值：

OV（OV代码签名证书）

EV（EV代码签名证书）

CreatedAt string 示例值：2026-02-25T10:00:00Z

证书实例的创建时间（UTC）。

Extension object 示例值：

证书实例扩展信息。

ContactInfo object 示例值：

联系人信息。

Email string 示例值：san.zhang@example.com

联系人邮箱。

Phone string 示例值：+86-13800000000

联系人电话。

LastName string 示例值：Zhang

联系人的姓氏。

FirstName string 示例值：San

联系人的名字。

Organization object 示例值：

组织信息。

City string 示例值：Beijing

城市。

Name string 示例值：Example Inc.

组织名称。

Country string 示例值：CN

国家或地区代码。

Province string 示例值：Beijing

省份或州。

PostalCode string 示例值：100000

邮政编码。

ShippingInfo object 示例值：

USB Key 邮寄信息。

Name string 示例值：Zhang San

收件人姓名。

Phone string 示例值：+86-13800000000

收件人电话。

Address string 示例值：No.1 Road, Chaoyang District

收件地址。

SupplierExtension object 示例值：

供应商扩展信息。

ShippingInfo string 示例值：运单号：SF1234567890，承运商：顺丰速运

供应商邮寄 USB Key 的相关信息，包括运单号、承运商等物流信息。

UpdatedAt string 示例值：2026-02-25T10:05:00Z

证书实例的更新时间（UTC）。

CommonName string 示例值：测试企业

组织名称。即证书申请时填写的公用名称（CN），通常为企业或组织的法定名称。

OrderBrand string 示例值：digicert

证书品牌。当前代码签名证书由 DigiCert 签发。

OrderStatus string 示例值：Issued

证书实例的状态。该参数有以下取值：

NotSubmitted：待提交申请

Pending：验证中

Issued：已签发

Cancelling：取消中

Canceled：已取消

Revoking：吊销中

Revoked：已吊销

Failed：申请失败

Unknown：未知

ProjectName string 示例值：default

证书实例所属火山引擎项目的名称。

OwnerAccountId string 示例值：210000XXXX

资源所属的火山引擎账号ID。

UpstreamFilter string 示例值：210001XXXX

火山用户账号ID。

CertificateNotAfter integer 示例值：1766735999

证书过期时间，单位：秒。

CertificateNotBefore integer 示例值：1735200000

证书生效时间，单位：秒。

CertificateFingerprint string 示例值：A53B846E14B33939E6CD7F9CF320FD9F96AB1D466A224CD28A38DC1388F51248

证书指纹（SHA-256）。

Total integer 示例值：1

符合查询条件的证书实例数。

PageSize integer 示例值：10

单页包含的最大证书实例数。

PageNumber integer 示例值：1

当前页码。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MalformedRequest	The request is malformed	请求参数格式不合法。
500	InternalError	The request has failed due to an unknown error.	未知错误。

证书中心