接口功能介绍

此接口提供查询用户集群节点组信息功能，系统接收用户输入的查询条件，返回符合条件的集群节点组详细信息。

接口约束

只允许查询处于运行中状态的集群的节点组信息。

接口是否审批

否

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": []
}

状态码

请参考状态码

错误码

请参考错误码

翼MapReduce服务