文档首页/ 密码安全中心 DEW/ API参考/ API/ 云平台密码系统服务/ 集群管理/ 查询密码服务集群列表 - ShowCcspClusterList
更新时间：2026-06-09 GMT+08:00
查看PDF
分享

查询密码服务集群列表 - ShowCcspClusterList

功能介绍

查询密码服务集群列表

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    cpcs:cluster:list

    List

    cluster *

    -

    -

    -

URI

GET /v1/{project_id}/dew/cpcs/cluster

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID。可参考获取项目ID获取。

约束限制：

不涉及

取值范围：

以IAM服务接口返回值为准，字符长度32-32

默认取值：

不涉及
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

参数解释：

指定查询返回记录条数，默认值10

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

offset

否

Integer

参数解释：

索引位置，从offset指定的下一条数据开始查询默认值为0

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

name

否

String

参数解释：

集群名称

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

service_type

否

String

参数解释：

集群所属的服务类型：

  • ENCRYPT_DECRYPT : 加解密服务；

  • SIGN_VERIFY : 签名验签服务；

  • KMS : 密钥管理服务；

  • TIMESTAMP : 时间戳服务；

  • COLLA_SIGN : 协同签名服务；

  • OTP : 动态令牌服务；

  • DB_ENCRYPT : 数据库加密服务；

  • FILE_ENCRYPT : 文件加密服务

  • TIMESTAMP : 时间戳服务；

  • DIGIT_SEAL : 电子签章服务；

  • SSL_VPN : ssl vpn服务；

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

sort_key

否

String

参数解释：

排序属性，目前支持以下属性：

  • create_time : 集群的创建时间（默认）

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

sort_dir

否

String

参数解释：

排序方向，支持以下值：

  • DESC : 降序（默认）

  • ASC : 升序

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。 通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）。使用AK、SK等认证方式，此处非必选

约束限制：

不涉及

取值范围：

IAM服务查询用户Token接口为准

默认取值：

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

参数解释：

满足条件的集群总数

取值范围：

不涉及

result

Array of CcspClusterInfo objects

参数解释：

集群列表

取值范围：

不涉及
表5 CcspClusterInfo

参数

参数类型

描述

task_id

String

参数解释：

任务ID

取值范围：

不涉及

project_id

String

参数解释：

项目ID

取值范围：

不涉及

domain_id

String

参数解释：

账号ID

取值范围：

不涉及

task_details

Array of objects

参数解释：

任务详情

取值范围：

不涉及

ccsp_id

String

参数解释：

ccsp集群id

取值范围：

不涉及

distributed_type

String

参数解释：

分布类型

取值范围：

不涉及

cluster_id

String

参数解释：

集群ID

取值范围：

不涉及

cluster_name

String

参数解释：

集群名称

取值范围：

不涉及

service_type

String

参数解释：

集群所属的服务

取值范围：

不涉及

type

String

参数解释：

集群的类型：

  • SHARED : 应用共享；

  • EXCLUSIVE : 应用独享

取值范围：

不涉及

instance_num

Integer

参数解释：

集群中包含的服务实例数量

取值范围：

不涉及

status

String

参数解释：

集群状态

取值范围：

不涉及

progress_info

String

参数解释：

进度信息

取值范围：

不涉及

vsm_num

Integer

参数解释：

集群使用VSM集群的vsm实例数量

取值范围：

不涉及

create_time

Long

参数解释：

集群的创建时间，UNIX时间戳，单位毫秒

取值范围：

不涉及

shared_ccsp

Boolean

参数解释：

是否共享ccsp

取值范围：

不涉及

enterprise_project_id

String

参数解释：

企业项目ID

取值范围：

不涉及

az

String

参数解释：

az

取值范围：

不涉及

请求示例

查询密码服务集群列表请求头中的X-Auth-Token字段需要填写token，且该token需要具有本API的访问权限

GET https://cpcs.com/v1/{project_id}/dew/cpcs/cluster?limit=2&offset=0

响应示例

状态码：200

请求已成功

{
  "total_num" : 2,
  "result" : [ {
    "task_id" : "e864d1df-ed0f-4b99-b01a-045802ce40a0",
    "project_id" : "d4e559b49b3b403da5279723299ed4a6",
    "domain_id" : "3bab8e245e854f68af5967c00dd43127",
    "task_details" : null,
    "ccsp_id" : "496745abc7dd44cda0d6af64555c750c",
    "distributed_type" : "NORMAL",
    "cluster_id" : "f05e0ae4b4bb442c82d4b8a0f16c4f84",
    "cluster_name" : "fvgbhnm",
    "service_type" : "COLLA_SIGN",
    "type" : "EXCLUSIVE",
    "instance_num" : 1,
    "status" : "RUNNING",
    "progress_info" : null,
    "vsm_num" : 1,
    "create_time" : 1752826659000,
    "shared_ccsp" : true,
    "enterprise_project_id" : null,
    "az" : null
  }, {
    "task_id" : "88018a11-7db3-45dc-acc2-301db3347e3e",
    "project_id" : "d4e559b49b3b403da5279723299ed4a6",
    "domain_id" : "3bab8e245e854f68af5967c00dd43127",
    "task_details" : null,
    "ccsp_id" : "496745abc7dd44cda0d6af64555c750c",
    "distributed_type" : "NORMAL",
    "cluster_id" : "b60526b15c254f64ad165cc438abe75e",
    "cluster_name" : "new协签",
    "service_type" : "COLLA_SIGN",
    "type" : "EXCLUSIVE",
    "instance_num" : 1,
    "status" : "RUNNING",
    "progress_info" : null,
    "vsm_num" : 1,
    "create_time" : 1752832663000,
    "shared_ccsp" : true,
    "enterprise_project_id" : null,
    "az" : null
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 集群管理

相关文档