You need to enable JavaScript to run this app.
证书中心

证书中心

复制全文
私有根CA
ListRootInstances - 查询私有根CA列表
复制全文
ListRootInstances - 查询私有根CA列表

调用本接口获取已创建的私有根CA(以下简称“根CA”)实例的列表。

请求说明

  • 接口名称:ListRootInstances
  • 请求方式:GET
  • 请求地址:
    • IPv4网络接入:pca.volcengineapi.com
    • 双栈网络接入(IPv4/IPv6):pca.volcengine-api.com

调试

请求参数

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

参数
类型
是否必填
示例值
描述
Action
String

ListRootInstances

要执行的操作,取值:ListRootInstances。

Version
String

2025-10-01

API的版本,取值:2025-10-01。

CommonName
String

Volcengine CA

指定一个公用名(CN)(对应证书中的CN字段)对根CA证书进行筛选。

SourceType
Integer

0

指定一个来源类型对根CA证书进行筛选。该参数有以下取值:

  • 0:在证书中心创建
  • 1:上传到证书中心
InstanceStatus
String

1

指定一个实例状态对根CA证书进行筛选。该参数有以下取值:

  • 0:未知
  • 1:已启用
  • 2:已停用
  • 4:已吊销
  • 8:已冻结(实例欠费)
  • 16:已过期
PageNumber
Integer

1

请求的页码。

PageSize
Integer

1

查询结果中每页的根CA数量。取值范围:1~20。

TagFilters
Array of Object

{
"Key": "wpYe",
"Value": "1MN"
}

标签筛选器。

InstanceId
String

pca_root_aXPEF****

指定一个实例ID对根CA证书进行筛选。

ProjectName
String

default

项目组名称。

返回参数

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

参数
类型
示例值
描述
Count
Integer

1

符合查询条件的根CA证书的数量。

PageNumber
Integer

1

返回的页码。

PageSize
Integer

1

查询结果中每页的根CA数量。取值范围:1~20。

Result
Array of Object

根证书实例列表

请求示例

POST /?Action=ListRootInstances&Version=2025-10-01 HTTP/1.1
Host: pca.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20251029T035917Z
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": "zM5Yw10SrVy",
  "SourceType": 639,
  "InstanceStatus": "U",
  "PageNumber": 920,
  "PageSize": 258,
  "TagFilters": [
    {
      "Key": "2xg4TWSmNi",
      "Values": [
        "PSfdINv1"
      ]
    }
  ],
  "InstanceId": "root-1234",
  "ProjectName": "default"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20251029115932095087057073293288",
    "Action": "ListRootInstances",
    "Version": "2025-10-01",
    "Service": "pca",
    "Region": "cn-beijing"
  },
  "Result": {
    "Count": 299,
    "PageNumber": 981,
    "PageSize": 831,
    "Result": [
      {
        "CommonName": "N6Cm4ZfJRF",
        "InstanceId": "J",
        "IssuedId": "DfxIaYa",
        "IssuedCommonName": "yG",
        "InstanceStatus": 289,
        "SerialNumber": "MMW",
        "SignatureAlgorithm": "19qclC",
        "Tag": "ZtOHwevKk",
        "Contact": {
          "Name": "2b8Dr9",
          "Email": "K8p0nGgEEr3",
          "PhoneNumber": "fdOvCmfkJ"
        },
        "Subject": {
          "Country": [
            "CN"
          ],
          "Organization": [
            "Volcano\n"
          ],
          "OrganizationalUnit": [
            "ti"
          ],
          "Locality": [
            "北京"
          ],
          "Province": [
            "Tk5oEc1WpaQ"
          ],
          "StreetAddress": [
            "2U"
          ],
          "PostalCode": [
            "RUgNBYLe8P"
          ],
          "SerialNumber": "2gziYho",
          "CommonName": "IwHZXHbMO"
        },
        "EncryptionAlgorithm": "yZI7rEK",
        "Duration": "RWGEX",
        "SourceType": 604,
        "Plan": "3Sj7g",
        "HasPrivateKey": false,
        "Tags": [
          {
            "Key": "ZINA",
            "Value": "nMtI8v"
          }
        ],
        "ProjectName": "ZM9S4",
        "DeployInfo": {
          "DeploySummary": [
            {
              "ServiceName": "yqYO2EbY",
              "ResourceCount": 560
            }
          ]
        },
        "CreateAt": "EGVd",
        "NotAfter": 172,
        "NotBefore": 223
      }
    ]
  }
}

错误码

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

状态码
错误码
错误信息
说明
200
InternalError

The request has failed due to an unknown error.

未知错误。

200
MalformedRequest

The request is malformed

请求参数格式不合法。

最近更新时间:2026.01.07 19:52:54
这个页面对您有帮助吗?
有用
有用
无用
无用