更新时间:2022-08-12 GMT+08:00

查询集群详情

功能介绍

查看指定集群的详细信息。该接口不兼容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

集群更新时间,十位时间戳。

billingType

String

集群计费模式。

dataCenter

String

集群工作区域。

vpc

String

VPC名称。

vpcId

String

VPC ID。

fee

String

创建集群所需费用,系统自动计算。

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

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

标签信息

chargingStartTime

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_001。

例如:Hadoop的component_id为MRS 2.1.1_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":"my-kualalumpur-1",
            "vpc": "vpc-autotest",        
            "vpcId": "e2978efd-ca12-4058-9332-1ca0bfbab592",        
            "duration":"0",
            "fee":"0",
            "hadoopVersion":"",
            "masterNodeSize":"s3.2xlarge.2.linux.bigdata",
            "coreNodeSize":"s3.2xlarge.2.linux.bigdata",
              "componentList": [{
    			"id": null,
    			"componentId": "MRS 3.1.0_001",
    			"componentName": "Hadoop",
    			"componentVersion": "3.1.1",
    			"external_datasources": null,
    			"componentDesc": "针对大数据集的分布式数据处理框架。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_002",
    			"componentName": "HBase",
    			"componentVersion": "2.2.3",
    			"external_datasources": null,
    			"componentDesc": "HBase是一个高可靠性、高性能、面向列、可伸缩的分布式存储系统。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_003",
    			"componentName": "Hive",
    			"componentVersion": "3.1.0",
    			"external_datasources": null,
    			"componentDesc": "方便查询、管理存储在分布式存储系统上的大数据集的数据仓库软件。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_004",
    			"componentName": "Spark2x",
    			"componentVersion": "2.4.5",
    			"external_datasources": null,
    			"componentDesc": "Spark2x是一个对大规模数据处理的快速和通用引擎,基于开源Spark2.x版本开发。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_005",
    			"componentName": "Tez",
    			"componentVersion": "0.9.2",
    			"external_datasources": null,
    			"componentDesc": "一个支持有向无环图的分布式计算框架。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_006",
    			"componentName": "Flink",
    			"componentVersion": "1.12.0",
    			"external_datasources": null,
    			"componentDesc": "Flink是一个开源的批流合一的消息处理系统。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_008",
    			"componentName": "Kafka",
    			"componentVersion": "2.11-2.4.0",
    			"external_datasources": null,
    			"componentDesc": "Kafka是一个分布式消息发布订阅系统。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_009",
    			"componentName": "Flume",
    			"componentVersion": "1.9.0",
    			"external_datasources": null,
    			"componentDesc": "Flume是一个分布式、高可用、高可靠的海量日志采集、聚合和传输系统。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_013",
    			"componentName": "Loader",
    			"componentVersion": "1.99.3",
    			"external_datasources": null,
    			"componentDesc": "Loader是专为Apache Hadoop和结构化数据库(如关系型数据库)设计的高效传输大量数据的工具。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_014",
    			"componentName": "Hue",
    			"componentVersion": "4.7.0",
    			"external_datasources": null,
    			"componentDesc": "Apache Hadoop的UI界面。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_015",
    			"componentName": "Oozie",
    			"componentVersion": "5.1.0",
    			"external_datasources": null,
    			"componentDesc": "Hadoop作业调度系统。",
    			"componentDescEn": null
    		},
    		{
    			"id": null,
    			"componentId": "MRS 3.1.0_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":"my-kualalumpur-1a",
            "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",
            "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": "s3.xlarge.2.linux.bigdata", 
                     "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": "s3.xlarge.2.linux.bigdata", 
                     "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": "s3.xlarge.2.linux.bigdata", 
                     "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": "s3.xlarge.2.linux.bigdata",
                   "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

查询集群详情成功。

异常状态码请参见状态码