查询集群详情_集群管理接口_API V1.1_API参考(巴黎区域)

功能介绍

查看指定集群的详细信息。该接口不兼容Sahara。

URI

URI格式
 GET /v1.1/{project_id}/cluster_infos/{cluster_id}

参数说明

表1 URI参数说明
名称	是否必选	说明
project_id	是	项目编号。获取方法，请参见获取项目ID。
cluster_id	是	集群ID。

请求消息

请求参数

无。

响应消息

表2 响应参数说明
参数名	参数类型	说明
clusterId	String	集群ID。
clusterName	String	集群名称。
masterNodeNum	String	集群部署的Master节点数量。
coreNodeNum	String	集群部署的Core节点数量。
totalNodeNum	String	集群部署的节点总数。
clusterState	String	集群状态，包括： starting：启动中的集群。 running：运行中的集群。 terminated：已删除的集群。 failed：失败的集群。 abnormal：异常的集群。 terminating：删除中的集群。 frozen：已冻结的集群。 scaling-out：扩容中的集群。 scaling-in：缩容中的集群。
createAt	String	集群创建时间，十位时间戳。
updateAt	String	集群更新时间，十位时间戳。
dataCenter	String	集群工作区域。
vpc	String	VPC名称。
vpcId	String	VPC ID。
hadoopVersion	String	Hadoop组件版本信息。
masterNodeSize	String	Master节点的实例规格。
coreNodeSize	String	Core节点的实例规格。
componentList	Array	组件列表信息，请参见表3。
externalIp	String	公网IP地址。
externalAlternateIp	String	公网备用IP地址。
internalIp	String	内网IP地址。
deploymentId	String	集群部署ID。
remark	String	集群备注信息。
orderId	String	创建集群的订单号。
azId	String	可用区域ID。
masterNodeProductId	String	Master节点产品ID。
masterNodeSpecId	String	Master节点规格ID。
coreNodeProductId	String	Core节点产品ID。
coreNodeSpecId	String	Core节点规格ID。
azName	String	可用区域名称。
instanceId	String	实例ID。
vnc	String	远程登录弹性云服务器的URI地址。
tenantId	String	项目编号。
volumeSize	Integer	磁盘存储空间。
subnetId	String	子网ID。
subnetName	String	子网名称。
securityGroupsId	String	安全组ID。
slaveSecurityGroupsId	String	非MASTER节点的安全组id，当前一个mrs集群只会使用一个安全组，所以该字段已经废弃，从兼容性考虑，该字段会返回和securityGroupsId同样的值。
bootstrap_scripts	Array	配置引导操作脚本信息。参数说明请参见表5。 MRS 1.7.2及以后版本支持该参数。
stageDesc	String	集群进度描述。安装集群进度包括： Verifying cluster parameters：校验集群参数中 Applying for cluster resources：申请集群资源中 Creating VM：创建虚拟机中 Initializing VM：初始化虚拟机中 Installing MRS Manager：安装MRS Manager中 Deploying cluster：部署集群中 Cluster installation failed：集群安装失败扩容集群进度包括： Preparing for cluster expansion：准备扩容中 Creating VM：创建虚拟机中 Initializing VM：初始化虚拟机中 Adding node to the cluster：节点加入集群中 Cluster expansion failed：集群扩容失败缩容集群进度包括： Preparing for cluster shrink：正在准备缩容 Decommissioning instance：实例退服中 Deleting VM：删除虚拟机中 Deleting node from the cluster：从集群删除节点中 Cluster shrink failed：集群缩容失败集群安装、扩容、缩容失败，stageDesc会显示失败的原因，详情请参见表8。
isMrsManagerFinish	Boolean	表示集群创建过程中，MRS Manager是否安装完成。 true：安装完成 false：安装未完成
safeMode	Integer	MRS集群运行模式： 0：普通集群 1：安全集群
clusterVersion	String	集群版本。
nodePublicCertName	String	公钥文件名称。
masterNodeIp	String	Master节点IP。
privateIpFirst	String	首选私有IP。
errorInfo	String	错误信息。
tags	String	标签信息
clusterType	Integer	集群类型
logCollection	Integer	集群安装失败时，是否搜集日志。 0：不收集 1：收集
taskNodeGroups	List<NodeGroup>	Task节点列表信息。参数说明请参见表4。
nodeGroups	List<NodeGroup>	Master节点、Core节点和Task节点列表信息。参数说明参见表4。
masterDataVolumeType	String	Master节点数据磁盘存储类别，目前支持SATA、SAS和SSD。
masterDataVolumeSize	Integer	Master节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。取值范围：100GB～32000GB
masterDataVolumeCount	Integer	Master节点数据磁盘个数。取值只能是1
coreDataVolumeType	String	Core节点数据磁盘存储类别，目前支持SATA、SAS和SSD。
coreDataVolumeSize	Integer	Core节点数据磁盘存储空间。为增大数据存储容量，创建集群时可同时添加磁盘。取值范围：100GB～32000GB
coreDataVolumeCount	Integer	Core节点数据磁盘个数。取值范围：1～10
scale	String	集群节点的变更状态（扩容/缩容/变更规格）。当该参数取值为空时，表示集群节点没有进行变更操作。取值范围： scaling-out：扩容中 scaling-in：缩容中 scaling-error：处于running状态，且上一次扩容/缩容/升级规格失败的集群 scaling-up：Master节点规格升级中 scaling_up_first：备Master节点规格升级中 scaled_up_first：备Master节点规格升级成功 scaled-up-success：Master节点规格升级成功

表3 componentList参数说明
参数名	参数类型	说明
componentId	String	组件ID。例如：Hadoop的component_id为MRS 3.1.0-LTS.1_001、MRS 1.8.9_001。
componentName	String	组件名称。
componentVersion	String	组件版本。
componentDesc	String	组件描述信息。

表4 NodeGroup参数说明
参数名	参数类型	说明
groupName	String	节点组名。
nodeNum	Integer	节点数量，取值范围0～500，Master节点和Core节点数量至少为1，Core与Task节点总数最大为500个。
nodeSize	String	节点的实例规格。
nodeSpecId	String	节点实例规格ID。
nodeProductId	String	节点实例产品ID。
vmProductId	String	节点虚拟机产品ID。
vmSpecCode	String	节点虚拟机产品规格。
rootVolumeSize	Integer	节点系统盘大小，不可配置，默认为40GB。
rootVolumeProductId	String	节点系统盘的产品ID。
rootVolumeType	String	节点系统盘的类型。
rootVolumeResourceSpecCode	String	节点系统盘产品规格。
rootVolumeResourceType	String	节点系统盘产品类型。
dataVolumeType	String	节点数据磁盘存储类别，目前支持SATA、SAS和SSD。 SATA：普通IO SAS：高IO SSD：超高IO
dataVolumeCount	Integer	节点数据磁盘存储数目。
dataVolumeSize	Integer	节点数据磁盘存储大小。
dataVolumeProductId	String	节点数据磁盘的产品ID。
dataVolumeResourceSpecCode	String	节点数据磁盘的产品规格。
dataVolumeResourceType	String	节点数据磁盘的产品类型。

表5 bootstrap_scripts参数说明
参数名	参数类型	说明
name	String	引导操作脚本的名称，同一个集群的引导操作脚本名称不允许相同。只能由数字、英文字符、空格、中划线和下划线组成，且不能以空格开头。可输入的字符串长度为1～64个字符。
uri	String	shell脚本的路径。设置为OBS桶的路径或虚拟机本地的路径。 OBS桶的路径：直接手动输入脚本路径。例如输入MRS提供的公共样例脚本路径。示例：s3a://bootstrap/presto/presto-install.sh，其中安装dualroles时，presto-install.sh脚本参数为dualroles , 安装worker时，presto-install.sh脚本参数为worker。根据Presto使用习惯，建议您在Active Master节点上安装dualroles，在Core节点上安装worker。虚拟机本地的路径：用户需要输入正确的脚本路径。脚本所在的路径必须以‘/’开头，以.sh结尾。
parameters	String	引导操作脚本参数。
nodes	Array String	引导操作脚本所执行的节点类型，包含Master、Core和Task三种类型。
active_master	Boolean	引导操作脚本是否只运行在主Master节点上。缺省值为false，表示引导操作脚本可运行在所有Master节点上。
before_component_start	Boolean	引导操作脚本执行的时间。目前支持“组件启动前”和“组件启动后”两种类型。缺省值为false,表示引导操作脚本在组件启动后执行。
fail_action	String	引导操作脚本执行失败后，是否继续执行后续脚本和创建集群。 continue:继续执行后续脚本。 errorout:终止操作。缺省值为errorout,表示终止操作。说明：建议您在调试阶段设置为“继续”，无论此引导操作是否执行成功，则集群都能继续安装和启动。
start_time	Long	单个引导操作脚本的执行时间。
state	String	单个引导操作脚本的运行状态。 PENDING IN_PROGRESS SUCCESS FAILURE

示例

请求示例
 无。

响应示例

{
    "cluster":{
        "clusterId":"bdb064ff-2855-4624-90d5-e9a6376abd6e",
        "clusterName":"c17022001",
        "masterNodeNum":"2",
        "coreNodeNum":"3",
        "clusterState":"scaling-in",
        "stageDesc": null,
        "createAt":"1487570757",
        "updateAt":"1487668974",
        "billingType":"Metered",
        "dataCenter":"eu-west-0",
        "vpc": "vpc-autotest",        
        "vpcId": "e2978efd-ca12-4058-9332-1ca0bfbab592",        
        "duration":"0",
        "fee":"0",
        "hadoopVersion":"",
        "masterNodeSize":"s1.8xlarge.linux.mrs",
        "coreNodeSize":"c6.4xlarge.4.linux.mrs",
          "componentList": [{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_001",
			"componentName": "Hadoop",
			"componentVersion": "3.1.1",
			"external_datasources": null,
			"componentDesc": "针对大数据集的分布式数据处理框架。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_002",
			"componentName": "HBase",
			"componentVersion": "2.2.3",
			"external_datasources": null,
			"componentDesc": "HBase是一个高可靠性、高性能、面向列、可伸缩的分布式存储系统。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_003",
			"componentName": "Hive",
			"componentVersion": "3.1.0",
			"external_datasources": null,
			"componentDesc": "方便查询、管理存储在分布式存储系统上的大数据集的数据仓库软件。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_004",
			"componentName": "Spark2x",
			"componentVersion": "2.4.5",
			"external_datasources": null,
			"componentDesc": "Spark2x是一个对大规模数据处理的快速和通用引擎,基于开源Spark2.x版本开发。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_005",
			"componentName": "Tez",
			"componentVersion": "0.9.2",
			"external_datasources": null,
			"componentDesc": "一个支持有向无环图的分布式计算框架。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_006",
			"componentName": "Flink",
			"componentVersion": "1.12.0",
			"external_datasources": null,
			"componentDesc": "Flink是一个开源的批流合一的消息处理系统。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_008",
			"componentName": "Kafka",
			"componentVersion": "2.11-2.4.0",
			"external_datasources": null,
			"componentDesc": "Kafka是一个分布式消息发布订阅系统。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_009",
			"componentName": "Flume",
			"componentVersion": "1.9.0",
			"external_datasources": null,
			"componentDesc": "Flume是一个分布式、高可用、高可靠的海量日志采集、聚合和传输系统。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_013",
			"componentName": "Loader",
			"componentVersion": "1.99.3",
			"external_datasources": null,
			"componentDesc": "Loader是专为Apache Hadoop和结构化数据库（如关系型数据库）设计的高效传输大量数据的工具。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_014",
			"componentName": "Hue",
			"componentVersion": "4.7.0",
			"external_datasources": null,
			"componentDesc": "Apache Hadoop的UI界面。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_015",
			"componentName": "Oozie",
			"componentVersion": "5.1.0",
			"external_datasources": null,
			"componentDesc": "Hadoop作业调度系统。",
			"componentDescEn": null
		},
		{
			"id": null,
			"componentId": "MRS 3.1.0-LTS.1_022",
			"componentName": "Ranger",
			"componentVersion": "2.0.0",
			"external_datasources": null,
			"componentDesc": "RANGER是一个基于Hadoop平台，旨在为复杂数据提供监控、操作、管理等权限管控接口的集中式框架。",
			"componentDescEn": null
		}],
        "externalIp":"100.XXX.XXX.XXX",
        "externalAlternateIp":"100.XXX.XXX.XXX",
        "internalIp":"192.XXX.XXX.XXX",
        "deploymentId":"4ac46ca7-a488-4b91-82c2-e4d7aa9c40c2",
        "remark":"",
        "orderId":"null",
        "azId":"null",
        "masterNodeProductId":"b35cf2d2348a445ca74b32289a160882",
        "masterNodeSpecId":"8ab05e503b4c42abb304e2489560063b",
        "coreNodeProductId":"dc970349d128460e960a0c2b826c427c",
        "coreNodeSpecId":"cdc6035a249a40249312f5ef72a23cd7",
        "azName":"eu-west-0a",
        "instanceId":"4ac46ca7-a488-4b91-82c2-e4d7aa9c40c2",
        "vnc":null,
        "tenantId":"3f99e3319a8943ceb15c584f3325d064",
        "volumeSize":600,
        "volumeType":"SATA",
        "subnetId": "6b96eec3-4f8d-4c83-93e2-6ec625001d7c",
        "subnetName":"subnet-ftest",
        "securityGroupsId":"930e34e2-195d-401f-af07-0b64ea6603f8",
        "slaveSecurityGroupsId":"2ef3343e-3477-4a0d-80fe-4d874e4f81b8",
        "stageDesc": "Installing MRS Manager",
        "mrsManagerFinish": false, 
        "safeMode":1,
        "clusterVersion":"MRS 3.1.0-LTS.1",
        "nodePublicCertName":"myp",
        "masterNodeIp":"192.XXX.XXX.XXX",
        "privateIpFirst":"192.XXX.XXX.XXX",
        "errorInfo":null,
        "tags":"k1=v1,k2=v2,k3=v3",
        "clusterType": 0,
        "logCollection": 1,
         "nodeGroups": [ 
            { 
                 "groupName": "master_node_default_group", 
                 "nodeNum": 1, 
                 "nodeSize": "s1.xlarge.linux.mrs", 
                 "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7", 
                 "vmProductId": "", 
                 "vmSpecCode": null, 
                 "nodeProductId": "dc970349d128460e960a0c2b826c427c", 
                 "rootVolumeSize": 480, 
                 "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", 
                 "rootVolumeType": "SATA", 
                 "rootVolumeResourceSpecCode": "", 
                 "rootVolumeResourceType": "", 
                 "dataVolumeType": "SATA", 
                 "dataVolumeCount": 1, 
                 "dataVolumeSize": 600, 
                 "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", 
                 "dataVolumeResourceSpecCode": "", 
                 "dataVolumeResourceType": ""
               },
               { 
                 "groupName": "core_node_analysis_group", 
                 "nodeNum": 1, 
                 "nodeSize": "s1.xlarge.linux.mrs", 
                 "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7", 
                 "vmProductId": "", 
                 "vmSpecCode": null, 
                 "nodeProductId": "dc970349d128460e960a0c2b826c427c", 
                 "rootVolumeSize": 480, 
                 "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", 
                 "rootVolumeType": "SATA", 
                 "rootVolumeResourceSpecCode": "", 
                 "rootVolumeResourceType": "", 
                 "dataVolumeType": "SATA", 
                 "dataVolumeCount": 1, 
                 "dataVolumeSize": 600, 
                 "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", 
                 "dataVolumeResourceSpecCode": "", 
                 "dataVolumeResourceType": ""
               },
               { 
                 "groupName": "task_node_analysis_group", 
                 "nodeNum": 1, 
                 "nodeSize": "s1.xlarge.linux.mrs", 
                 "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7", 
                 "vmProductId": "", 
                 "vmSpecCode": null, 
                 "nodeProductId": "dc970349d128460e960a0c2b826c427c", 
                 "rootVolumeSize": 480, 
                 "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", 
                 "rootVolumeType": "SATA", 
                 "rootVolumeResourceSpecCode": "", 
                 "rootVolumeResourceType": "", 
                 "dataVolumeType": "SATA", 
                 "dataVolumeCount": 1, 
                 "dataVolumeSize": 600, 
                 "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572", 
                 "dataVolumeResourceSpecCode": "", 
                 "dataVolumeResourceType": ""
               } 

            ],
        "taskNodeGroups": [
            {
               "groupName": "task_node_default_group",
               "nodeNum": 1,
               "nodeSize": "s1.xlarge.linux.mrs",
               "nodeSpecId": "cdc6035a249a40249312f5ef72a23cd7",
               "vmProductId": "",
               "vmSpecCode": null,
               "nodeProductId": "dc970349d128460e960a0c2b826c427c",
               "rootVolumeSize": 480,
               "rootVolumeProductId": "16c1dcf0897249758b1ec276d06e0572",
               "rootVolumeType": "SATA",
               "rootVolumeResourceSpecCode": "",
               "rootVolumeResourceType": "",
               "dataVolumeType": "SATA",
               "dataVolumeCount": 1,
               "dataVolumeSize": 600,
               "dataVolumeProductId": "16c1dcf0897249758b1ec276d06e0572",
               "dataVolumeResourceSpecCode": "",
               "dataVolumeResourceType": "",
               "AutoScalingPolicy": null
               }
            ],
         "masterDataVolumeType": "SATA",
         "masterDataVolumeSize": 600,
         "masterDataVolumeCount": 1,
         "coreDataVolumeType": "SATA",
         "coreDataVolumeSize": 600,
         "coreDataVolumeCount": 1,
      }
  }

状态码

状态码如表6所示。

表6 状态码
状态码	描述
200	查询集群详情成功。

异常状态码请参见状态码。

查询集群详情

功能介绍

URI

请求消息

响应消息

示例

状态码

意见反馈

文档内容是否对您有帮助？