接口功能介绍
此接口提供查询用户集群节点组信息功能，系统接收用户输入的查询条件，返回符合条件的集群节点组详细信息。
接口约束
只允许查询处于运行中状态的集群的节点组信息。
接口是否审批
否
URI
GET /v1/emr/openapi/cluster/clusterNodeGroup/getByClusterId
Content-Type
application/json
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
clusterId | 是 | String | 集群id | da595eb1d81503b323fdc01d9bf786b7 |
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
Cluster-Id | 是 | String | 集群id | da595eb1d81503b323fdc01d9bf786b7 | / |
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
statusCode | Integer | 状态码 | 200 | / |
message | String | 用来简述当前接口调用状态以及必要提示信息 | 请求成功 | / |
error | String | 错误码，请求成功时，不返回该字段 | EMR_400001 | / |
returnObj | Array of Objects | 返回结果 | / | returnObj |
表 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 | / |
枚举参数
无
请求头header示例
{
"Cluster-Id":"da595eb1d81503b323fdc01d9bf786b7"
}
请求url示例
https://emr-global.ctapi.ctyun.cn/v1/emr/openapi/cluster/clusterNodeGroup/getByClusterId?clusterId=da595eb1d81503b323fdc01d9bf786b7
请求体body示例
无
响应示例
请求成功返回值示例
{
"statusCode": 200,
"message": "success",
"returnObj": [
{
"id": "1751878497877790722",
"clusterId": "da595eb1d81503b323fdc01d9bf786b7",
"payType": 1,
"nodeGroupType": "MASTER",
"nodeGroupName": "master",
"imageId": "f8d28855-ffda-426d-96e2-0f6bf46877e0",
"hostNum": 3,
"computeSpecificationId": 101,
"iaasVmSpecCode": "s7.2xlarge.4",
"cpuNum": 8,
"memory": 32,
"diskSpecificationList": "[{\"diskFunctionType\":1,\"diskFunctionName\":\"系统盘\",\"diskType\":\"cloud\",\"diskTypeName\":\"云硬盘\",\"ioType\":\"SSD-genric\",\"ioTypeName\":\"通用型SSD\",\"volume\":200,\"diskNum\":1},{\"diskFunctionType\":2,\"diskFunctionName\":\"数据盘\",\"diskType\":\"cloud\",\"diskTypeName\":\"云硬盘\",\"ioType\":\"SSD-genric\",\"ioTypeName\":\"通用型SSD\",\"volume\":200,\"diskNum\":2}]",
"createTime": 1706515356000,
"updateTime": 1706515356000,
"mountPublicIp": false,
"iaasVmSpecId": "b307034d-cbc3-27bb-24f7-a97565814236",
"highest": null
},
{
"id": "1751878497890373634",
"clusterId": "da595eb1d81503b323fdc01d9bf786b7",
"payType": 1,
"nodeGroupType": "CORE",
"nodeGroupName": "core",
"imageId": "f8d28855-ffda-426d-96e2-0f6bf46877e0",
"hostNum": 1,
"computeSpecificationId": 101,
"iaasVmSpecCode": "s7.2xlarge.4",
"cpuNum": 8,
"memory": 32,
"diskSpecificationList": "[{\"diskFunctionType\":1,\"diskFunctionName\":\"系统盘\",\"diskType\":\"cloud\",\"diskTypeName\":\"云硬盘\",\"ioType\":\"SSD-genric\",\"ioTypeName\":\"通用型SSD\",\"volume\":200,\"diskNum\":1},{\"diskFunctionType\":2,\"diskFunctionName\":\"数据盘\",\"diskType\":\"cloud\",\"diskTypeName\":\"云硬盘\",\"ioType\":\"SSD-genric\",\"ioTypeName\":\"通用型SSD\",\"volume\":200,\"diskNum\":2}]",
"createTime": 1706515356000,
"updateTime": 1706515356000,
"mountPublicIp": false,
"iaasVmSpecId": "b307034d-cbc3-27bb-24f7-a97565814236",
"highest": null
}
]
}
请求失败返回值示例
{
"statusCode": 200,
"error": "EMR_400021",
"message": "不是合法的集群id",
"returnObj": []
}