ListLeafInstances - 查询私有证书列表--证书中心-火山引擎

文档中心

证书中心

私有证书

ListLeafInstances - 查询私有证书列表

调用本接口获取已签发的私有证书的列表。

请求说明

接口名称：ListLeafInstances
请求方式：GET
请求地址：
- IPv4网络接入：pca.volcengineapi.com
- 双栈网络接入（IPv4/IPv6）：pca.volcengine-api.com

调试

API Explorer

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

去调试

请求参数

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

Query

参数	类型	是否必填	示例值	描述
Action	String	是	ListLeafInstances	要执行的操作，取值：ListLeafInstances。
Version	String	是	2025-10-01	API的版本，取值：2025-10-01。

Body

参数	类型	是否必填	示例值	描述
CommonName	String	否	www.example.com	指定一个公用名（对应证书中的CN字段）对私有证书进行筛选。
InstanceStatus	Integer	否	1	指定一个实例状态对私有证书进行筛选。该参数有以下取值： 0：未知 1：正常运行 2：已停用 4：已吊销 8：已冻结（实例欠费） 16：已过期
SourceType	String	否	0	指定一个来源类型对根CA证书进行筛选。该参数有以下取值： 0：在证书中心创建 1：上传到证书中心
PageNumber	Integer	否	1	请求的页码。
PageSize	Integer	否	1	查询结果中每页的根CA数量。取值范围：1~20。
TagFilters	Array of Object	否	-	标签筛选器。
IssuedId	String	否	pca_sub_MlRaK****	指定上一级CA实例（子CA实例）的ID对私有证书进行筛选。
InstanceId	String	否	pca_leaf_M6gaihuZRcO****	指定一个实例ID对私有证书进行筛选。
ProjectName	String	否	default	私有证书所属项目组。

返回参数

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

参数	类型	示例值	描述
PageNumber	Integer	1	返回的页码。
PageSize	Integer	1	返回结果中每页的私有证书数量。
Count	Integer	1	符合查询条件的私有证书的数量。
Result	Array of Object	-	私有证书列表。

请求示例

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

{
  "CommonName": "noxJ3vmNn",
  "InstanceStatus": 209,
  "SourceType": "5Qtn1LpHP",
  "PageNumber": 969,
  "PageSize": 737,
  "TagFilters": [
    {
      "Key": "ejhrrwgC",
      "Values": [
        "yEAHCbnd"
      ]
    }
  ],
  "IssuedId": "sub-1234",
  "InstanceId": "leaf-1234",
  "ProjectName": "default"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202510291604182030391601949189E9",
    "Action": "ListLeafInstances",
    "Version": "2025-10-01",
    "Service": "pca",
    "Region": "cn-beijing"
  },
  "Result": {
    "PageNumber": 537,
    "PageSize": 914,
    "Count": 824,
    "Result": [
      {
        "InstanceId": "F",
        "IssuedId": "gAnCd",
        "IssuedCommonName": "LEC",
        "InstanceStatus": 107,
        "CommonName": "FEnyQASsNS",
        "Tag": "vgFYhXT1",
        "SignatureAlgorithm": "hm",
        "Duration": "c817B",
        "SerialNumber": "MmcZW",
        "NotAfter": 830,
        "NotBefore": 963,
        "CreateAt": "ln4oP",
        "Contact": {
          "Name": "yvMhCcvBhj",
          "Email": "W",
          "PhoneNumber": "Ql"
        },
        "Subject": {
          "Country": [
            "CN"
          ],
          "Organization": [
            "Volcano\n"
          ],
          "OrganizationalUnit": [
            "ti"
          ],
          "Locality": [
            "北京"
          ],
          "Province": [
            "0M6q"
          ],
          "StreetAddress": [
            "37Ax"
          ],
          "PostalCode": [
            "bEC"
          ],
          "SerialNumber": "C",
          "CommonName": "HfvzKNu"
        },
        "EncryptionAlgorithm": "Pu4vwAqDJ",
        "SourceType": 388,
        "Plan": "xfwPSQ",
        "HasPrivateKey": true,
        "Tags": [
          {
            "Key": "7m5tgu",
            "Value": "vB7"
          }
        ],
        "ProjectName": "aAk",
        "DeployInfo": {
          "DeploySummary": [
            {
              "ServiceName": "5Z2suKATJ",
              "ResourceCount": 332
            }
          ]
        }
      }
    ]
  }
}

错误码

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

状态码	错误码	错误信息	说明
200	InternalError	The request has failed due to an unknown error.	未知错误。
200	InvalidParameter	The specified parameter %s is invalid.	指定的参数值无效。
200	MalformedRequest	The request is malformed	请求参数格式不合法。

最近更新时间：2026.01.07 17:39:54

这个页面对您有帮助吗？

有用

无用

证书中心

请求说明 #

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #