CodeSignCertificateListInstances - 查询代码签名证书实例列表--证书中心-火山引擎

文档中心

证书中心

API参考

CodeSignCertificateListInstances - 查询代码签名证书实例列表

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

请求说明

请求频率：同一个租户每秒最多允许请求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	Array of String	否	["200"]	证书实例状态。
PageNumber	Integer	是	1	设置要返回的页码。默认值：1。
PageSize	Integer	是	10	设置单页包含的最大证书实例数。默认值：10。最大值：100。
Project	String	否	default	指定证书实例所属火山引擎项目的名称。
Type	String	否	EV	证书级别。代码签名证书有以下取值： OV（OV代码签名证书） EV（EV代码签名证书）

返回参数

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

参数	类型	示例值	描述
Data	Array of Object		证书实例列表。
Total	Integer	1	符合查询条件的证书实例数。
PageSize	Integer	10	单页包含的最大证书实例数。
PageNumber	Integer	1	当前页码。

请求示例

POST /?Action=CodeSignCertificateListInstances&Version=2024-10-01 HTTP/1.1
Host: certificate-service.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260420T011520Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260420/cn-beijing/certificate_service/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "CertificateExpireAfter": 2024,
  "CertificateExpireBefore": 2024,
  "CommonName": "测试企业",
  "Id": "cert-310a6640e2ef4c1dbe5065c62821****",
  "Name": "测试企业",
  "OrderStatus": [
    "200"
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "Project": "default",
  "Type": "EV"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20260420091536100048010254C06478",
    "Action": "CodeSignCertificateListInstances",
    "Version": "2024-10-01",
    "Service": "certificate_service",
    "Region": "cn-beijing"
  },
  "Result": {
    "Data": [
      {
        "Id": "cert-c88df6d4a1b348c3b714b746d3cc****",
        "Name": "测试企业",
        "Type": "EV",
        "CreatedAt": "2026-02-25T10:00:00Z",
        "Extension": {
          "ContactInfo": {
            "Email": "san.zhang@example.com ",
            "Phone": "+86-13800000000",
            "LastName": "Zhang",
            "FirstName": "San"
          },
          "Organization": {
            "City": "Beijing",
            "Name": "Example Inc. ",
            "Country": "CN",
            "Province": "Beijing",
            "PostalCode": "100000"
          },
          "ShippingInfo": {
            "Name": "Zhang San",
            "Phone": "+86-13800000000",
            "Address": "No.1 Road, Chaoyang District"
          },
          "SupplierExtension": {
            "ShippingInfo": "运单号：SF1234567890，承运商：顺丰速运"
          }
        },
        "UpdatedAt": "2026-02-25T10:05:00Z",
        "CommonName": "测试企业",
        "OrderBrand": "digicert",
        "OrderStatus": "Issued",
        "ProjectName": "default",
        "OwnerAccountId": "210000XXXX",
        "UpstreamFilter": "210001XXXX",
        "CertificateNotAfter": 1766735999,
        "CertificateNotBefore": 1735200000,
        "CertificateFingerprint": "A53B846E14B33939E6CD7F9CF320FD9F96AB1D466A224CD28A38DC1388F51248"
      }
    ],
    "Total": 1,
    "PageSize": 10,
    "PageNumber": 1
  }
}

错误码

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

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

最近更新时间：2026.04.21 14:28:05

这个页面对您有帮助吗？

有用

无用

证书中心

请求说明 #

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #