# 获取控制节点列表（待废弃） - GetMastersByUID #### 功能介绍 该API用于获取指定集群的控制节点列表。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-cce/cce_02_0099.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cce/cce_02_0395.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /api/v2/projects/{project_id}/clusters/{cluster_id}/masters 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 账号的项目ID **默认取值：** 不涉及 | | cluster_id | 是 | String | **参数解释：** 集群ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)。 **约束限制：** 不涉及 **取值范围：** 集群ID **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | **参数解释：** 消息体的类型（格式） **约束限制：** GET方法不做校验 **取值范围：** - application/json - application/json;charset=utf-8 - application/x-pem-file - multipart/form-data（注：存在FormData参数时使用） **默认取值：** 不涉及 | | X-Auth-Token | 是 | String | **参数解释：** 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见[获取token](https://support.huaweicloud.com/api-cce/cce_02_0004.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | **参数解释**： API类型 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： List | | apiVersion | String | **参数解释**： API版本 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： v2 | | items | Array of [MasterNode] objects | **参数解释**： 控制节点信息列表 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表4MasterNode | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | **参数解释**： API类型 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： Host | | apiVersion | String | **参数解释**： API版本 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： v2 | | metadata | [MasterNodeMetadata] object | **参数解释**： 控制节点元数据 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | spec | [MasterNodeSpec] object | **参数解释**： 控制节点详细信息 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | status | [MasterNodeStatus] object | **参数解释**： 控制节点状态信息 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表5MasterNodeMetadata | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uid | String | **参数解释**： 控制节点ID **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | name | String | **参数解释**： 控制节点名称 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | creationTimestamp | String | **参数解释**： 控制节点创建时间 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | updateTimestamp | String | **参数解释**： 控制节点最后更新时间 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表6MasterNodeSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | az | String | **参数解释**： 控制节点所在可用区 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | privateIp | String | **参数解释**： 控制节点私有IP地址 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | flavor | String | **参数解释**： 控制节点云服务器类型 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | cpu | Integer | **参数解释**： 控制节点CPU核数 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | memory | Integer | **参数解释**： 控制节点内存大小 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | serverId | String | **参数解释**： 控制节点云服务器ID **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | extendParam | Map\ | **参数解释**： 控制节点额外参数 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表7MasterNodeStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**： 节点状态 **约束限制**： 不涉及 **取值范围**： - Active： 运行中 - Abnormal：不可用 **默认取值**： 不涉及 | #### 请求示例 无 #### 响应示例 **状态码：200** 获取VPC下节点信息成功 ``` { "kind" : "List", "apiVersion" : "v2", "items" : [ { "kind" : "Host", "apiVersion" : "v2", "metadata" : { "name" : "nvdkl-master-1", "uid" : "a6321127-95c4-11f0-addc-0255ac1001b6", "creationTimestamp" : "2025-09-20 01:53:48.291391 +0000 UTC", "updateTimestamp" : "2025-09-20 02:00:59.92607 +0000 UTC" }, "spec" : { "az" : "cn-north-7c", "privateIp" : "192.168.0.169", "flavor" : "st6.xlarge.2", "cpu" : 4, "memory" : 8, "serverId" : "d59880cc-f757-487b-853f-a29134bdcc14", "extendParam" : { "portId" : "5763bb17-8d59-47df-8cbc-6ab91ad3eab4" } }, "status" : { "status" : "Active" } } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 获取VPC下节点信息成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cce/ErrorCode.html)。