文档首页> MapReduce服务 MRS> API参考(巴黎区域)> API V1.1> 集群管理接口> 查询主机列表
更新时间：2022-12-14 GMT+08:00
查看PDF

查询主机列表

功能介绍

该接口用于查询输入集群的主机列表详情。

URI

  • URI格式

    GET /v1.1/{project_id}/clusters/{cluster_id}/hosts

  • 参数说明
    表1 URI参数说明

    名称

    是否必选

    说明

    project_id

    是

    项目编号。获取方法，请参见获取项目ID。

    cluster_id

    是

    集群ID。

请求消息

表2 请求参数说明

名称

是否必选

参数类型

说明

pageSize

否

Integer

分页查询每页返回的最大集群数量。

取值范围：[1～2147483646]，默认值为10。

currentPage

否

Integer

当前查询页码。默认值为1。

响应消息

表3 响应参数说明

参数名

参数类型

说明

total

Integer

主机列表总数。

hosts

Array

主机参数，请参见表4。
表4 主机参数说明

参数名

参数类型

说明

id

String

虚拟机ID

ip

String

虚拟机IP地址

flavor

String

虚拟机规格ID

type

String

虚拟机类型，当前支持MasterNode，CoreNode，TaskNode

name

String

虚拟机名称

status

String

虚拟机当前状态

mem

String

内存

cpu

String

CPU核数

root_volume_size

String

操作系统盘容量

data_volume_type

String

数据盘类型

data_volume_size

Integer

数据盘容量

data_volume_count

Integer

数据盘个数

示例

  • 请求示例

    无。

  • 响应示例
    {
  "total": 5,
  "hosts": [
    {
      "id": "063d1d47-ae91-4a48-840c-b3cfe4efbcf0",
      "name": "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_IQhiC",
      "ip": "192.168.0.169",
      "status": "ACTIVE",
      "flavor": "c6.4xlarge.4.linux.mrs",
      "type": "Core",
      "mem": "16384",
      "cpu": "8",
      "root_volume_size": "480",
      "data_volume_type": "SATA",
      "data_volume_size": 600,
      "data_volume_count": 1
    },
    {
      "id": "dc5c6208-faa2-4727-a65a-2b1ce235d350",
      "name": "a78e161c-d14f-4b68-8c2d-0219920ce844_node_master1_ASzkl",
      "ip": "192.168.0.156",
      "status": "ACTIVE",
      "flavor": "c2.4xlarge.linux.mrs",
      "type": "Master",
      "mem": "32768",
      "cpu": "16",
      "root_volume_size": "480",
      "data_volume_type": "SATA",
      "data_volume_size": 600,
      "data_volume_count": 1
    },
    {
      "id": "c0ce793d-848b-448a-835b-ea0cac534b09",
      "name": "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_ANnRN",
      "ip": "192.168.0.243",
      "status": "ACTIVE",
      "flavor": "c6.4xlarge.4.linux.mrs",
      "type": "Core",
      "mem": "16384",
      "cpu": "8",
      "root_volume_size": "480",
      "data_volume_type": "SATA",
      "data_volume_size": 600,
      "data_volume_count": 1
    },
    {
      "id": "95c23e43-ef6e-4732-b6ed-a5f1c7779fae",
      "name": "a78e161c-d14f-4b68-8c2d-0219920ce844_node_core_uRRiA",
      "ip": "192.168.0.126",
      "status": "ACTIVE",
      "flavor": "c6.4xlarge.4.linux.mrs",
      "type": "Core",
      "mem": "16384",
      "cpu": "8",
      "root_volume_size": "480",
      "data_volume_type": "SATA",
      "data_volume_size": 600,
      "data_volume_count": 1
    },
    {
      "id": "63bdbf75-1133-4a94-8c27-1fa12c8b9e70",
      "name": "a78e161c-d14f-4b68-8c2d-0219920ce844_node_master2_StqFu",
      "ip": "192.168.0.22",
      "status": "ACTIVE",
      "flavor": "c2.4xlarge.linux.mrs",
      "type": "Master",
      "mem": "32768",
      "cpu": "16",
      "root_volume_size": "480",
      "data_volume_type": "SATA",
      "data_volume_size": 600,
      "data_volume_count": 1
    }
  ]
}

状态码

状态码如表5所示。

表5 状态码

状态码

描述

200

查询主机列表信息成功。

异常状态码请参见状态码。

父主题： 集群管理接口