接口功能介绍
根据集群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
https://emr-global.ctapi.ctyun.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": {}
}
状态码
请参考 状态码
错误码
请参考 错误码
