查询 C2PA 证书实例列表

使用说明

本接口按分页方式返回 C2PA 证书实例列表，可通过公用名、备注、状态、过期时间、项目和标签等条件过滤。

返回的每个实例仅包含摘要信息。如需查看单个实例的完整详情（包括证书主题、签发者、指纹、联系人等），请调用 DescribeC2PAInstance 接口；如需获取证书内容与证书链，请调用 GetC2PAInstance 接口。

注意事项

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

请求说明

请求方法：POST

接入地址：pca.volcengineapi.com

API 版本：2025-10-01

调试

API Explorer

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

去调试

请求参数

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

Query

Action string 必选示例值：ListC2PAInstances

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

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

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

Body

CommonName string 可选示例值：sign.example.com

证书公用名（CN）。

InstanceIdList string[] 可选示例值：["c2pa-cert-b7eb5c7094cc4e89****"]

证书实例 ID 列表。

Description string 可选示例值：业务线A签名证书

证书实例备注名。支持模糊匹配。

CertificateExpireBefore string 可选示例值：2027-12-31 23:59:59

证书到期时间早于该时间。时间格式：2006-01-02 15:04:05（即 yyyy-MM-dd HH:mm:ss）。

CertificateExpireAfter string 可选示例值：2006-01-02 15:04:05

证书到期时间晚于该时间。时间格式：2006-01-02 15:04:05（即 yyyy-MM-dd HH:mm:ss）。

StatusList string[] 可选示例值：["issued"]

证书实例状态列表。取值：

pending：验证中

issued：已签发

cancelled：已取消

terminated：已终结

Project string 可选示例值：default

证书实例所属项目名称。

TagFilters object[] 可选示例值：-

标签过滤条件。

Key string 必选示例值：env

资源标签键。

Values string[] 可选示例值：["production", "staging"] ["devops-team"]

资源标签值列表，表示该 Key 下允许匹配的一个或多个值。

Limit integer 可选示例值：20

分页大小，即每页返回的实例数。默认值：20。最大值：100。

Page integer 可选示例值：1

分页页码，从 1 开始。默认值：1。

返回参数

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

Total integer 示例值：1

符合查询条件的实例总数。

Page integer 示例值：1

当前页码。

Limit integer 示例值：20

分页大小。

Instances object[] 示例值：-

证书实例列表。

InstanceId string 示例值：c2pa-cert-b7eb5c7094cc4e89ac806802361****

证书实例 ID。

Account string 示例值：210000****

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

Status string 示例值：Issued

证书实例状态。取值同请求参数StatusList。

Plan string 示例值：globalsign_smime_ov_1y

证书规格。取值：

globalsign_smime_ov_1y：GlobalSign OV S/MIME 1 年期

globalsign_smime_ov_2y：GlobalSign OV S/MIME 2 年期

Description string 示例值：业务线A签名证书

证书实例备注名。

CommonName string 示例值：sign.example.com

证书公用名（CN）。

Email string 示例值：sign@example.com

证书主体中的企业邮箱。

Organization string 示例值：Example Inc.

证书主体中的组织名称（O）。

NotBefore string 示例值：2026-09-01 00:00:00 +0000 UTC

证书生效时间（UTC）。

NotAfter string 示例值：2027-09-01 00:00:00 +0000 UTC

证书到期时间（UTC）。

CreateTime string 示例值：2026-09-01 10:00:00 +0000 UTC

实例创建时间（UTC）。

Project string 示例值：default

证书实例所属项目名称。

Tags object 示例值：-

证书实例绑定的标签。

Key string 示例值：env

资源标签键。

Value string 示例值：production

资源标签值。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	MalformedRequest	The request is malformed.	请求格式错误。
400	InvalidParameter.TagFilters	TagFilters is invalid.	TagFilters 的结构、标签键值或数量不符合标签筛选规则。
400	InvalidParameter.InstanceIdList	InstanceIdList contains too many instance IDs.	InstanceIdList 包含的实例 ID 超过 100 个。
400	InvalidParameter.InstanceIdListHasEmpty	InstanceIdList contains an empty instance ID.	InstanceIdList 中至少包含一个空的实例 ID。
400	InvalidParameter.InstanceIdListHasInvalid	InstanceIdList contains an invalid instance ID.	InstanceIdList 中至少包含一个格式无效的实例 ID。
400	InvalidParameter.CertificateExpire	CertificateExpireBefore and CertificateExpireAfter must use the format '2006-01-02 15:04:05'.	CertificateExpireBefore 或 CertificateExpireAfter 不是 UTC 时间格式 2006-01-02 15:04:05。
500	InternalError	The request failed due to an internal error.	服务内部错误。

证书中心