名称: DescribeCluster
使用场景: 调用 DescribeCluster,查询 E-MapReduce(EMR)集群的基本信息,包括:付费、ECS机器概况和 EMR服务列表等。
前置条件: 已创建过 EMR 集群。
RequestParam:
TOP公共参数:
Action=DescribeCluster
Version=2022-04-15
Region=cn-beijing
名称 | 类型 | 必填 | 描述 | 示例 |
---|---|---|---|---|
ClusterId | String | N | EMR集群的集群ID | emr-xxx |
http(s)://[Endpoint]/?Action=DescribeCluster &ClusterId=emr-12345 &Region=cn-beijing &<公共请求参数>
名称 | 类型 | 描述 |
---|---|---|
ClusterId | String | EMR 集群的集群 ID |
AccountId | Long | 集群创建的主账号 ID |
ClusterName | String | 集群名称 |
ClusterType | String | 集群类型 |
Status | String | 集群状态,取值如下:
|
ReleaseVersion | String | 集群版本 |
PayType | String | 付费类型 |
Project | String | 集群所属项目 |
CreatorId | String | 创建者的火山引擎账号 ID |
CreatorName | String | 创建者的火山引擎账号名称 |
Archived | Boolean | 是否已归档 |
InstanceNum | Integer | 节点数量 |
ExpireTime | TimeStamp | 到期时间 |
ShutDownTime | TimeStamp | 关停时间 |
LaunchTime | TimeStamp | 启动时间 |
ReleaseTime | TimeStamp | 释放时间 |
CreateTime | TimeStamp | 创建时间 |
UpdateTime | TimeStamp | 更新时间 |
ClusterMetadataHostingType | Array | 服务的数据库信息 |
Information | Object | 集群的相关信息 |
RequiredServices | Array | 必选服务 |
OptionalServices | Array | 可选服务 |
AutoRenew | Boolean | 是否开启自动续费 |
HighAvailabilityEnabled | Boolean | 是否开启高可用 |
AuthorityManagementEnabled | Boolean | 是否开启权限管理 |
KerberosStatus | String | Kerberos 状态 |
IsFavorite | Boolean | 是否已收藏 |
SceneId | String | 场景 Id |
SceneName | String | 场景名称 |
CanModifyChargeType | Boolean | 是否可以转换计费类型 |
HaVip | 参考 VPC 文档 | |
● VipId | String | Vip 的 Id |
● VipAddress | String | Vip 的地址 |
EcsRole | String | 集群绑定的 ECS 角色 |
MasterNodesPublicDnsInfo | Array | MASTER 节点公网域名列表 |
NeedRepairPortAccessRules | Boolean | 是否需要一键修复端口访问规则 |
Tags | List | 集群标签 |
PhsEnabled | Boolean | 是否开启了 public history server |
{ "ResponseMetadata": { "RequestId": "20211231172623010174235038095xxx", "Action": "DescribeCluster", "Version": "2022-04-15", "Service": "emr_qa", "Region": "cn-north-4", "Error": null }, "Result": { "ClusterId": "emr-xxx", "AccountId": 2100001324, "ClusterName": "Ambari接口代理测试", "ClusterType": "Hadoop", "Status": "RUNNING", "ReleaseVersion": "1.2.0", "ChargeType": "PostPaid", "Project": "default", "CreatorId": 25557, "CreatorName": "emr_dp", "Archived": false, "instanceNum": 3, "ExpireTime": null, "ShutDownTime": null, "LaunchTime": "2022-02-25T19:24:01", "ReleaseTime": null, "CreateTime": "2022-02-25T19:14:06", "UpdateTime": "2022-02-28T15:33:31", "ClusterMetadataHostingType":[ { "Correlation":"HIVE", "DbType":null, "DbConnId":null, "HmsId":null }, { "Correlation":"RANGER", "DbType":null, "DbConnId":null, "HmsId":null }, { "Correlation":"AIRFLOW", "DbType":null, "DbConnId":null, "HmsId":null }, { "Correlation":"DOLPHIN_SCHEDULER", "DbType":null, "DbConnId":null, "HmsId":null }, { "Correlation":"OOZIE", "DbType":null, "DbConnId":null, "HmsId":null } ], "Information":[ { "vpcId":"vpc-13fyxxxxx", "securityGroupId":"sg-1xxxxx", "subNetId":"subnet-rrgxxxxxx", "region":"cn-beijing", "zone":"cn-beijing-b", "eipNetworkLine":null, "CauseOfFailure":null } ], "RequiredServices": [ { "Name": "HDFS", "Version": "3.3.1", "DisplayName": "HDFS" }, { "Name": "HIVE", "Version": "3.1.2", "DisplayName": "Hive" } ], "OptionalServices": [ { "Name": "RANGER", "Version": "2.1.0", "DisplayName": "Ranger" } ], "AutoRenew": false, "HighAvailabilityEnabled": false, "KerberosStatus": "ENABLED", "IsFavorite": true, "SceneId": "DataLake", "SceneName": "数据湖", "CanModifyChargeType": true } }
{ "ResponseMetadata": { "RequestId": null, "Action": null, "Version": null, "Service": null, "Region": null, "Error": { "Status": 500, "Code": "UNKNOWN_ERROR", "Message": "Cluster emr-xxx is not found." } }, "Result": null }