调用本接口获取已创建的私有根CA(以下简称“根CA”)实例的列表。
pca.volcengineapi.compca.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证书进行筛选。该参数有以下取值:
|
InstanceStatus | String | 否 | 1 | 指定一个实例状态对根CA证书进行筛选。该参数有以下取值:
|
PageNumber | Integer | 否 | 1 | 请求的页码。 |
PageSize | Integer | 否 | 1 | 查询结果中每页的根CA数量。取值范围:1~20。 |
TagFilters | Array of Object | 否 | { | 标签筛选器。 |
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 | 未知错误。 |
200 | MalformedRequest | 请求参数格式不合法。 |