根據集群id查詢節點組信息V2
更新時間 2025-10-16 17:40:27
最近更新時間: 2025-10-16 17:40:27
分享文章
接口功能介紹
根據集群id查詢節點組詳情信息，返回集群id、付費類型、節點組類型、鏡像id、主機數量、主機規格、CPU核數、內存大小、磁盤規格等信息。
接口約束
只允許查詢處于運行中狀態的集群的節點組信息。
URI
GET /v2/emr/openapi/cluster/clusterNodeGroup/getByClusterId
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| clusterId | 是 | String | 集群id | e7afb3bd9d7117d116893c03a352f4e3 |
請求參數
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| 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 |
枚舉參數
無
請求示例
請求url
//emr-global.ctapi.daliqc.cn/v2/emr/openapi/cluster/clusterNodeGroup/getByClusterId?clusterId=e7afb3bd9d7117d116893c03a352f4e3
請求頭header
無
請求體body
無
響應示例
請求成功示例：
{
"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
},
{
"id": "1848620195091943425",
"clusterId": "e7afb3bd9d7117d116893c03a352f4e3",
"payType": 1,
"nodeGroupType": "CORE",
"nodeGroupName": "core-1",
"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
},
{
"id": "1848620195100332034",
"clusterId": "e7afb3bd9d7117d116893c03a352f4e3",
"payType": 1,
"nodeGroupType": "TASK",
"nodeGroupName": "task-1",
"imageId": "35e905b2-96f3-449d-a569-89bad1b419c5",
"hostNum": 1,
"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
}
]
}
驗簽失敗示例：
{
"statusCode": 500,
"error": "EMR_401000",
"message": "OpenAPI認證失敗",
"returnObj": {}
}
請求參數值無效示例：
{
"statusCode": 500,
"error": "EMR_401002",
"message": "請求參數值無效",
"returnObj": "{\"clusterId\":\"不能為空\"}"
}
查詢無權限的集群示例：
{
"statusCode": 500,
"error": "EMR_401004",
"message": "非法操作",
"returnObj": {}
}
非運行集群無法查看示例：
{
"statusCode": 500,
"error": "EMR_401006",
"message": "非運行中集群無法查看信息",
"returnObj": {}
}
狀態碼
請參考
錯誤碼
請參考
