# 查询密码服务集群列表 - ShowCcspClusterList #### 功能介绍 查询密码服务集群列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-dew/dew_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dew/dew_02_0308.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cpcs:cluster:list | List | cluster \* | - | - | - | #### URI GET /v1/{project_id}/dew/cpcs/cluster 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID。可参考[获取项目ID](https://support.huaweicloud.com/api-dew/dew_02_0009.html)获取。 **约束限制：** 不涉及 **取值范围：** 字符长度为32 **默认取值：** 不涉及 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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等认证方式，此处非必选 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total_num | Integer | **参数解释：** 满足条件的集群总数 **取值范围：** 不涉及 | | result | Array of [CcspClusterInfo] objects | **参数解释：** 集群列表 **取值范围：** 不涉及 | 表5CcspClusterInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 请求已成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dew/ErrorCode.html)。