查詢集群節點組詳情V2
更新時間 2025-10-16 17:41:08
最近更新時間: 2025-10-16 17:41:08
分享文章
接口功能介紹
此接口提供查詢用戶集群節點組詳情功能，系統接收用戶輸入的查詢條件，返回符合條件的集群節點組信息。
接口約束
只允許查詢處于運行中狀態的集群的節點組詳情。
URI
POST /v2/emr/openapi/cluster/nodeGroup/getGroupAndHostByCondition
路徑參數
無
Query參數
無
請求參數
請求頭header參數
無
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| clusterId | 是 | String | 集群id | bdbbc8cc1288a78e5851839dc26f58b9 | |
| nodeState | 否 | Integer | 主機狀態（1:啟動中,2:正在關機,4:已刪除,8:運行中,9:已關機） | 1 | |
| selectKey | 否 | String | 模糊查詢參數，可以通過節點名稱、內網IP、外網IP進行模糊查詢 | 10.0.0.2 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 狀態碼，成功：200，失敗：500 | 200 | |
| message | String | 用來簡述當前接口調用狀態以及必要提示信息 | 請求成功 | |
| error | String | 錯誤碼，請求成功時，不返回該字段 | EMR_400000 | |
| returnObj | Object | 返回結果 |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| id | String | 節點組id | 175187849787779 | |
| clusterId | String | 集群id | da595eb1d81503b323fdc01d9bf786b7 | |
| payType | Integer | 付費類型 | 1 | |
| nodeGroupType | String | 節點類型code碼 | MASTER | |
| nodeGroupName | String | 節點類型code值 | master | |
| imageId | String | 鏡像id | f8d28855-ffda-426d-96e2-0f6bf46877e0 | |
| hostNum | Integer | 主機數量 | 3 | |
| computeSpecificationId | Integer | 主機規格id | 101 | |
| iaasVmSpecCode | String | IAAS虛機規格編碼 | s7.2xlarge.4 | |
| cpuNum | Integer | cpu核數集群列表 | 8 | |
| memory | Integer | 內存大小 | 32 | |
| diskSpecificationList | String | 磁盤規格列表 | [{diskFunctionType:1,diskFunctionName:系統盤,diskType:cloud,diskTypeName:云硬盤,ioType:SSD-genric,ioTypeName:通用型SSD,volume:200,diskNum:1}] | |
| createTime | Integer | 創建時間 | 1706515356000 | |
| updateTime | Integer | 更新時間 | 1706515356000 | |
| mountPublicIp | Boolean | 是否掛載公網 | false | |
| iaasVmSpecId | String | IAAS虛機規格id | b307034d-cbc3-27bb-24f7-a97565814236 | |
| highest | Boolean | 節點組規格是否最高 | false | |
| regionId | String | 資源池id | bb9fdb42056f11eda1610242ac110002 | |
| availableZoneId | String | 可用區id | cn-huadong1-jsnj1A-public-ctcloud | |
| vpcId | String | vpc id | vpc-fr2xjo1gj0 | |
| clusterHostDtoList | Array of Objects | 集群節點組列表 | clusterHostDtoList |
表 clusterHostDtoList
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| id | String | 主鍵id | 0088babec7bab47b20409df6646db856 | |
| nodeGroupId | String | 節點組id | 1753298494213554178 | |
| iaasHostId | String | 平臺主機id | b2f2377d-3f0b-bc74-b9c5-67bb557b0e63 | |
| hostName | String | 主機名稱 | bigdata-emr-vm-l7zb3wnk | |
| manageIp | String | 管理IP | 10.2.3.0 | |
| serviceIp | String | 內網IP | 192.168.0.149 | |
| publicIp | String | 公網IP | 212.168.0.150 | |
| ipv6ServiceIp | String | ipv6內網ip | 240e:982:db0f:6c00:d1ea:8588:69fa:96 | |
| ipv6PublicIp | String | ipv6公網ip | 240e:982:db0f:6c00:d1ea:8588:69fa:97 | |
| state | Integer | 機器狀態枚舉(創建主機時機器狀態，非即時狀態） | 8 | |
| vpcId | String | vpc id | vpc-fr2xjo1gj0 | |
| subnetId | String | 子網id | subnet-vkixrw8xw7 | |
| regionId | String | 資源池id | bb9fdb42056f11eda1610242ac110002 | |
| availableZoneId | String | 可用區id | cn-huadong1-jsnj1A-public-ctcloud | |
| eipId | String | 彈性IP id | eip_sssww | |
| bandwidthId | String | 綁定ipv6的帶寬id | bandwidth-fnzgeac441 | |
| jobId | String | 開機jobId | compute_8d9eabb5-89a5-44de-beae-583bf624f6d5 | |
| masterOrderId | String | IT的主訂單id | b8d68f4c36734227ac4c8fb7bba58ae9 | |
| iaasMasterOrderId | String | IAAS的主訂單id | INT022024091218592892305018 | |
| paasResourceId | String | 訂單來源 | 6276b490c2504f4ba90e90e857b043e4 | |
| isDeleted | Integer | 判斷是否刪除了當前節點（發生撤單時會刪除該節點）(0:未刪除,1:已刪除) | 0 | |
| createTime | Integer | 創建時間 | 1706515356000 | |
| updateTime | Integer | 更新時間 | 1706515356000 | |
| isDoctorAgent | Boolean | 是否安裝Doctor插件 | False | |
| hostStateValue | String | 機器狀態 | 運行中 | |
| deployRoleInstance | Array of Strings | 部署角色實例 | [ "NodeMaster" ] |
枚舉參數
無
請求示例
請求url
//emr-global.ctapi.daliqc.cn/v2/emr/cluster/openapi/clusterNodeGroup/getGroupAndHostByCondition
請求頭header
無
請求體body
{
"clusterId":"e7afb3bd9d7117d116893c03a352f4e3"
}
響應示例
退訂成功示例：
{
"statusCode": 200,
"message": "success",
"returnObj": [
{
"id": "1848620195079360514",
"clusterId": "e7afb3bd9d7117d116893c03a352f4e3",
"payType": 1,
"nodeGroupType": "MASTER",
"nodeGroupName": "master",
"imageId": "35e905b2-96f3-449d-a569-89bad1b419c5",
"hostNum": 3,
"computeSpecificationId": 98,
"iaasVmSpecCode": "s7.2xlarge.4",
"cpuNum": 8,
"memory": 32,
"diskSpecificationList": "[{\"diskFunction\":\"SYSTEM\",\"diskFunctionName\":\"系統盤\",\"diskType\":\"cloud\",\"diskTypeName\":\"云硬盤\",\"ioType\":\"SATA\",\"ioTypeName\":\"普通IO\",\"volume\":80,\"diskNum\":1},{\"diskFunction\":\"DATA\",\"diskFunctionName\":\"數據盤\",\"diskType\":\"cloud\",\"diskTypeName\":\"云硬盤\",\"ioType\":\"SATA\",\"ioTypeName\":\"普通IO\",\"volume\":80,\"diskNum\":1}]",
"createTime": 1729580375000,
"updateTime": 1730021300000,
"mountPublicIp": false,
"iaasVmSpecId": "b307034d-cbc3-27bb-24f7-a97565814236",
"highest": null,
"regionId": "bb9fdb42056f11eda1610242ac110002",
"availableZoneId": "cn-huadong1-jsnj1A-public-ctcloud",
"vpcId": "vpc-yrecox87qe",
"clusterHostDtoList": [
{
"id": "1848620196580921345",
"nodeGroupId": "1848620195079360514",
"iaasHostId": "7b9e58a6-8270-568d-c1d4-16e996f43718",
"hostName": "bigdata-vm-1729580376-k09wy",
"manageIp": "-",
"serviceIp": "192.168.0.42",
"publicIp": "-",
"ipv6ServiceIp": "",
"ipv6PublicIp": "-",
"state": 8,
"vpcId": "vpc-yrecox87qe",
"subnetId": "subnet-pxpru3r0as",
"regionId": "bb9fdb42056f11eda1610242ac110002",
"availableZoneId": "cn-huadong1-jsnj1A-public-ctcloud",
"eipId": null,
"bandwidthId": null,
"jobId": "compute_9ed0c255-998b-419f-98f8-8281f06ff485",
"masterOrderId": "",
"iaasMasterOrderId": "INT022024102214593521544350",
"paasResourceId": "PaasResourceId",
"isDeleted": 0,
"createTime": 1729580375000,
"updateTime": 1729580375000,
"hostStateValue": "運行中",
"deployRoleInstance": [
"NameNode",
"JournalNode",
"ZKFC",
"HDFSClient",
"ZKServer",
"KDCMaster",
"SSSD",
"TrinoCoordinator",
"YARNClient",
"FlinkHistoryServer",
"FlinkClient"
]
},
{
"id": "1848620196585115649",
"nodeGroupId": "1848620195079360514",
"iaasHostId": "49980a64-aa7e-44ab-6296-9c8136482c27",
"hostName": "bigdata-vm-1729580376-k09wy-0001",
"manageIp": "-",
"serviceIp": "192.168.0.46",
"publicIp": "-",
"ipv6ServiceIp": "",
"ipv6PublicIp": "-",
"state": 8,
"vpcId": "vpc-yrecox87qe",
"subnetId": "subnet-pxpru3r0as",
"regionId": "bb9fdb42056f11eda1610242ac110002",
"availableZoneId": "cn-huadong1-jsnj1A-public-ctcloud",
"eipId": null,
"bandwidthId": null,
"jobId": "compute_9ed0c255-998b-419f-98f8-8281f06ff485",
"masterOrderId": "",
"iaasMasterOrderId": "INT022024102214593521544350",
"paasResourceId": "PaasResourceId",
"isDeleted": 0,
"createTime": 1729580375000,
"updateTime": 1729580375000,
"hostStateValue": "運行中",
"deployRoleInstance": [
"JournalNode",
"HDFSClient",
"ZKServer",
"Slapd",
"SSSD",
"ResourceManager",
"JobHistory",
"YARNClient",
"FlinkClient"
]
},
{
"id": "1848620196585115650",
"nodeGroupId": "1848620195079360514",
"iaasHostId": "848b2edb-8635-149c-71dd-1cdba1035377",
"hostName": "bigdata-vm-1729580376-k09wy-0002",
"manageIp": "-",
"serviceIp": "192.168.0.48",
"publicIp": "-",
"ipv6ServiceIp": "",
"ipv6PublicIp": "-",
"state": 8,
"vpcId": "vpc-yrecox87qe",
"subnetId": "subnet-pxpru3r0as",
"regionId": "bb9fdb42056f11eda1610242ac110002",
"availableZoneId": "cn-huadong1-jsnj1A-public-ctcloud",
"eipId": null,
"bandwidthId": null,
"jobId": "compute_9ed0c255-998b-419f-98f8-8281f06ff485",
"masterOrderId": "",
"iaasMasterOrderId": "INT022024102214593521544350",
"paasResourceId": "PaasResourceId",
"isDeleted": 0,
"createTime": 1729580375000,
"updateTime": 1729580375000,
"hostStateValue": "運行中",
"deployRoleInstance": [
"NameNode",
"JournalNode",
"ZKFC",
"HDFSClient",
"ZKServer",
"KDCSlave",
"Slapd",
"SSSD",
"ResourceManager",
"YARNClient",
"FlinkClient"
]
}
]
}
]
}
請求參數類型不正確示例：
{
"statusCode": 500,
"error": "EMR_401001",
"message": "請求參數類型錯誤",
"returnObj": "{\"nodeState\": \"應為int范圍內整數\",\"clusterId\": \"應為字符串\"}"
}
請求參數值無效示例：
{
"statusCode": 500,
"error": "EMR_401002",
"message": "請求參數值無效",
"returnObj": "{\"clusterId\":\"不能為空\"}"
}
查詢無權限的集群示例：
{
"statusCode": 500,
"error": "EMR_401004",
"message": "非法操作",
"returnObj": {}
}
非運行集群無法查看示例：
{
"statusCode": 500,
"error": "EMR_401006",
"message": "非運行中集群無法查看信息",
"returnObj": {}
}
狀態碼
請參考
錯誤碼
請參考
