获取集群详情

获取集群详情

URI

GET /hdinsight/v1/insights/{id}

请求头

Content-Type:application/json

请求参数

名称 位置 类型 是否必须 默认值 描述
id path Long 集群id

返回参数

名称 位置 类型 描述
name body String 集群名称
uuid body String 集群uuid
status body String 集群状态(实例状态表)
createdTime body Date 格林威治时间
nodeCount body int 节点数量
cluster body Cluster(Cluster) 集群详情
eip body String 弹性公网ip
network body NetWork(NetWork) 网络配置
instanceGroups body List 实例组
event body List 事件

示例

请求示例

/hdinsight/v1/insights/9

响应示例

{
    "name": "liujian019",
    "uuid": "d62c65c5-7ba0-499a-b4cc-dcddea2912ae",
    "status": "CREATE_FAILED",
    "createdTime": "2019-05-27T08:18:02Z",
    "nodeCount": 5,
    "cluster": {
        "userName": "admin",
        "ambariServerUrl": null,
        "clusterExposedServicesForTopologies": null
    },
    "eip": null,
    "network": {
        "name": "Default-vpc"
    },
    "instanceGroups": [
        {
            "nodeCount": 3,
            "group": "worker",
            "template": {
                "volumeSize": 100,
                "volumeCount": 0,
                "instanceType": "hdinsight_2C8G40G_general"
            },
            "securityGroup": {
                "securityGroupId": "250d2e22-c7ea-4216-85ab-7f29275bf5d3"
            },
            "metadata": [
                {
                    "privateIp": null,
                    "instanceType": null,
                    "instanceId": null,
                    "instanceGroup": "worker",
                    "discoveryFQDN": null
                },
                {
                    "privateIp": null,
                    "instanceType": null,
                    "instanceId": null,
                    "instanceGroup": "worker",
                    "discoveryFQDN": null
                },
                {
                    "privateIp": null,
                    "instanceType": null,
                    "instanceId": null,
                    "instanceGroup": "worker",
                    "discoveryFQDN": null
                }
            ],
            "hostMetadata": null
        },
        {
            "nodeCount": 1,
            "group": "master",
            "template": {
                "volumeSize": 100,
                "volumeCount": 0,
                "instanceType": "hdinsight_2C8G40G_general"
            },
            "securityGroup": {
                "securityGroupId": "250d2e22-c7ea-4216-85ab-7f29275bf5d3"
            },
            "metadata": [
                {
                    "privateIp": null,
                    "instanceType": null,
                    "instanceId": null,
                    "instanceGroup": "master",
                    "discoveryFQDN": null
                }
            ],
            "hostMetadata": null
        },
        {
            "nodeCount": 0,
            "group": "compute",
            "template": {
                "volumeSize": 100,
                "volumeCount": 0,
                "instanceType": "hdinsight_2C8G40G_general"
            },
            "securityGroup": {
                "securityGroupId": "cfa07245-0a9b-47fa-a7f3-0a18e1163dc6"
            },
            "metadata": [],
            "hostMetadata": null
        },
        {
            "nodeCount": 1,
            "group": "manage",
            "template": {
                "volumeSize": 0,
                "volumeCount": 0,
                "instanceType": "hdinsight_2C4G100G_general"
            },
            "securityGroup": {
                "securityGroupId": "default"
            },
            "metadata": [
                {
                    "privateIp": null,
                    "instanceType": null,
                    "instanceId": null,
                    "instanceGroup": "manage",
                    "discoveryFQDN": null
                }
            ],
            "hostMetadata": null
        }
    ],
    "events": [
        {
            "eventType": "CREATE_FAILED",
            "eventTimestamp": "2019-05-27T08:18:43Z",
            "eventMessage": "Infrastructure creation failed. Reason: Failed to create the stack for CloudContext{id=40, name='liujian019', platform='StringType{value='OPENSTACK'}', owner='ningsheng'} due to: Resource CREATE failed: Forbidden: resources.ambari_master_4: Quota exceeded for ram: Requested 8192, but already used 180224 of 180224 ram (HTTP 403) (Request-ID: req-8054b7d3-7c43-4534-b714-e07f5fd8f6bb)"
        },
        {
            "eventType": "CREATE_IN_PROGRESS",
            "eventTimestamp": "2019-05-27T08:18:22Z",
            "eventMessage": "Creating infrastructure"
        }
    ]
}

返回值

请参考通用请求返回值

错误码

错误代码 错误信息 Http状态码 说明
300.001001 集群资源不存在 500 不存在对应id编号的集群
300.011400 集群操作请求校验失败 500 集群操作请求校验失败

查询集群列表

描述

查询已创建的托管Hadoop集群列表。

URI

GET /hdinsight/v1/insights

请求参数

No parameters

返回参数

名称 位置 类型 描述
id body Long 集群id
uuid body String 集群uuid
eip body String 弹性公网ip
clusterType body String 集群类型
name body String 集群名称
instanceGroups body List 实例组
status body String 集群状态(实例状态表)
createdTime body Date 格林威治时间

示例

请求示例

 无参数

响应示例

[
    {
        "id": 77,
        "uuid": "0915860d-7b4f-4b89-a6d1-073899ada309",
        "eip": null,
        "clusterType": "数据分析",
        "name": "hdinsightmq-20190605144804",
        "instanceGroups": [
            {
                "group": "worker",
                "nodeCount": 3
            },
            {
                "group": "master",
                "nodeCount": 1
            },
            {
                "group": "compute",
                "nodeCount": 0
            },
            {
                "group": "manage",
                "nodeCount": 1
            }
        ],
        "status": "REQUESTED"
        "createdTime" : "2019-05-27T08:18:02Z"
    } 
]

返回值

请参考通用请求返回值

错误码

错误代码 错误信息 Http状态码 说明
300.011400 集群操作请求校验失败 500 集群操作请求校验失败

查询集群名称是否存在

该接口用于查询托管Hadoop集群名称是否存在。

URI

POST /hdinsight/v1/insights/{name}/action/is-exist

请求参数

名称 位置 类型 是否必须 默认值 描述
name path String 集群名称

返回参数

名称 位置 类型 是否必须 默认值 描述
result body boolean 集群名称
requestId body String 请求id
code body String 错误代码
message body String 错误描述

示例

请求示例

/hdinsight/v1/insights/ning000001/action/is-exist

响应示例

{
    "result": true
}

错误码

| 错误代码    | 错误信息      | Http状态码  | 说明             |
|------------|--------------|------------|------------------|
| 300.001001 | 集群资源不存在|  500        | 不存在对应id编号的集群   |
| 300.011400 | 集群操作请求校验失败 |500| 集群操作请求校验失败   |

重命名集群名称

该接口用于更改托管Hadoop集群名称。

请求头

Content-Type:application/json

URI

PUT /hdinsight/v1/insights/{id}/rename?newName=

请求参数

名称 位置 类型 是否必须 默认值 描述
id path Long 集群id
newName path String 新集群名称

返回参数

名称 位置 类型 是否必须 默认值 描述
requestId body String 请求id
code body String 错误代码
result body boolean 集群名称
message body String 错误描述

示例

请求示例

/hdinsight/v1/insights/5/rename?newName=123

响应示例

{
 "result": "success"
}

错误码

错误代码 错误信息 Http状态码 说明
300.001001 集群资源不存在 500 不存在对应id编号的集群
300.011400 集群操作请求校验失败 500 集群操作请求校验失败

获取集群数量

获得用户所述集群的数量

URI

GET /hdinsight/v1/insights/instance-num

请求参数

返回参数

名称 类型 是否必须 默认值 描述
data Long 数量

示例

请求示例

/hdinsight/v1/insights/instance-num

响应示例

{
   "data": 2,
}

返回值

请参考通用请求返回值

错误码

错误代码 错误信息 Http状态码 说明
300.001001 集群资源不存在 500 不存在对应id编号的集群
300.011400 集群操作请求校验失败 500 集群操作请求校验失败

绑定eip

绑定外网ip

URI

POST /hdinsight/v1/insights/{id}/action/bind-eip

请求参数

名称 位置 类型 是否必须 默认值 描述
eipId path String ip地址

返回参数

名称 类型 是否必须 默认值 描述
result String 绑定结果

示例

请求示例

/hdinsight/v1/insights/{5}/action/bind-eip

响应示例

{
    "result": "true"
}

返回值

请参考通用请求返回值

错误码

错误代码 错误信息 Http状态码 说明
300.001001 集群资源不存在 500 ip绑定失败
300.011400 集群操作请求校验失败 500 集群操作请求校验失败

解绑eip

解绑外网ip

URI

POST /hdinsight/v1/insights/{id}/action/unbind-eip

请求参数

No parameters

返回参数

名称 位置 类型 是否必须 默认值 描述
result path String 绑定结果

示例

请求示例

/hdinsight/v1/insights/{5}/action/unbind-eip

响应示例

{
    "result": "success"
}

返回值

请参考通用请求返回值

错误码

错误代码 错误信息 Http状态码 说明
300.011001 can not find eip id 500 ip解绑失败
300.011400 集群操作请求校验失败 500 集群操作请求校验失败

查看集群类型

该接口用于查看集群类型。

URI

GET /hdinsight/v1/cluster-types

请求参数

No parameters

返回参数

名称 类型 描述
name String 资源名称
id Long 资源ID
hostGroupCount Integer 主机组数量
publicInAccount boolean 资源在帐户中是否可见
status String 集群状态(实例状态表)
components List 组件列表
hostGroups List 主机组

示例

请求示例

无参数

响应示例

[
    {
        "name": "HBASE",
        "id": 55,
        "hostGroupCount": 2,
        "status": "DEFAULT",
        "components": [
            "HDFS(3.1.1)",
            "ZOOKEEPER(3.4.6)",
            "HBASE(2.0.0)"
        ],
        "hostGroups": [
            "master",
            "worker"
        ],
        "public": true
    },
    {
        "name": "Hadoop",
        "id": 56,
        "hostGroupCount": 3,
        "status": "DEFAULT",
        "components": [
            "HDFS(3.1.1)",
            "YARN(3.1.1)",
            "HIVE(3.1.0)",
            "TEZ(0.9.1)",
            "SPARK(2.3.1)",
            "ZOOKEEPER(3.4.6)",
            "SQOOP(1.4.7)"
        ],
        "hostGroups": [
            "master",
            "worker",
            "compute"
        ],
        "public": true
    }
]

错误码

错误代码 错误信息 Http状态码 说明
300.011001 未找到eip 500 ip解绑失败
300.011400 集群操作请求校验失败 500 集群操作请求校验失败

查看节点类型规格

该接口用于查看节点类型规格。

URI

GET /hdinsight/v1/vm-types

请求参数

No parameters

返回参数

名称 类型 描述
value String 节点规格
diskResponses String 存储类型详情
memory Integer 内存大小
cpu Integer cpu大小
name String 存储类型

示例

请求示例

无参数

响应示例

{
    "manage": [
        {
            "name": "hdinsight_2C4G100G_general",
            "cpu": 2,
            "memory": 4,
            "disk": 100
        }
    ],
    "master": [
        {
            "name": "hdinsight_4C16G80G_general",
            "cpu": 4,
            "memory": 16,
            "disk": 80
        },
        {
            "name": "hdinsight_8C32G80G_general",
            "cpu": 8,
            "memory": 32,
            "disk": 80
        },
        {
            "name": "hdinsight_16C64G80G_general",
            "cpu": 16,
            "memory": 64,
            "disk": 80
        }
    ],
    "worker": [
        {
            "name": "hdinsight_2C8G40G_general",
            "cpu": 2,
            "memory": 8,
            "disk": 40
        },
        {
            "name": "hdinsight_4C16G80G_general",
            "cpu": 4,
            "memory": 16,
            "disk": 80
        },
        {
            "name": "hdinsight_8C32G80G_general",
            "cpu": 8,
            "memory": 32,
            "disk": 80
        }
    ]
}

错误码

错误代码 错误信息 Http状态码 说明
300.011001 can not find eip id 500 ip解绑失败
300.011400 集群操作请求校验失败 500 集群操作请求校验失败