调用CreateClusterV2,创建一个E-MapReduce集群。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateClusterV2

系统规定参数。取值:CreateClusterV2。

BootstrapAction.N.Name String name

引导操作名字。

BootstrapAction.N.Path String oss://bucket/path

引导操作脚本路径。

ClusterType String HADOOP

集群类型,取值如下:

  • HADOOP
  • KAFKA
  • FLINK
  • GATEWAY
  • DRUID
  • DATA_SCIENCE
  • CLICKHOSUE
Config.N.ConfigKey String fs.trash.interval

自定义配置项的Key。

Config.N.ConfigValue String 60

自定义配置项的值。

Config.N.FileName String yarn-site

自定义配置项所属文件名。

Config.N.ServiceName String YARN

自定义配置项服务名(大写)。

EmrVer String EMR-3.15.0

EMR版本。

HostGroup.N.DiskCapacity Integer 80

机器组的数据盘容量。

HostGroup.N.DiskCount Integer 4

机器组的数据盘数量。

HostGroup.N.DiskType String CLOUD_SSD

机器组的系统盘类型,取值如下:

  • CLOUD:普通云盘
  • CLOUD_EFFICIENCY:高效云盘
  • CLOUD_SSD:SSD云盘
HostGroup.N.HostGroupName String 主实例组

机器组名字。

HostGroup.N.HostGroupType String MASTER

待查询的机器组类型,取值如下:

  • MASTER:主实例组
  • CORE:核心实例组
  • TASK:计算实例组
说明 目前MASTERCORE均只支持设置一个组。
HostGroup.N.InstanceType String ecs.mn4.2xlarge

机器组型号。

HostGroup.N.NodeCount Integer 2

机器组节点数。

HostGroup.N.SysDiskCapacity Integer 80

机器组的系统盘容量。

HostGroup.N.SysDiskType String CLOUD_SSD

机器组的系统盘类型,取值如下:

  • CLOUD:普通云盘
  • CLOUD_EFFICIENCY:高效云盘
  • CLOUD_SSD:SSD云盘
Name String bi_hadoop

集群的名字。长度限制为 1~64 个字符,只允许包含中文、字母、数字、-、_。

RegionId String cn-hangzhou

地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

UserInfo.N.Password String pwd

Knox用户的密码。

UserInfo.N.UserId String 123456789

Knox用户的用户RAM ID。

UserInfo.N.UserName String username

Knox用户的用户名。

ZoneId String cn-hangzhou-b

可用区ID。您可以调用DescribeZones查看阿里云地域下的可用区。

LogPath String oss//bucketname/path

OSS日志路径。

SecurityGroupId String sg-bp1id7ajv83kmqwq****

安全组ID。可以在ECS中创建一个然后使用。需要确认的是,如果使用已有的安全组,会被增加上默认安全组策略:入只开放22端口,出开放所有端口。

IsOpenPublicIp Boolean true

是否开启公网IP,取值如下:

  • true:开启公网IP地址。如果开启,默认会带有8 MB的带宽。
  • false:不开启公网IP地址。
SecurityGroupName String emr-sg

需要新建的安全组名称。如果不指定安全组ID,那么将使用这个名字创建一个新的安全组。当集群创建完成以后,可以在集群详情中看到创建的安全组ID。这个安全组将会带有默认的安全组策略:入只开放22端口,出开放所有端口。

ChargeType String PostPaid

付费类型,取值如下:

  • PostPaid:按量付费
  • PrePaid:包年包月
Period Integer 2

包年包月时间(包月数有:1、2、3、4、5、6、7、8、9、12、24、36)。ChargeType=PrePaid时,必填。

AutoRenew Boolean false

包年包月集群是否自动续费,取值如下:

  • true:自动续费
  • flase:不自动续费
AutoPayOrder Boolean true

是否自动付费,取值如下:

  • true:自动付费
  • false:不自动付费
VpcId String vpc-bp1l4urd87xlh7i4b****

VPC ID。

VSwitchId String vsw-bp10tvjyc77psy0z5****

交换机ID。

NetType String VPC

网络类型。

UserDefinedEmrEcsRole String AliyunEmrEcsDefaultRole

用于ECS调用的EMR权限名。

OptionSoftWareList.N RepeatList ["ZOOKEEPER","LIVY"]

可选软件列表。

HighAvailabilityEnable Boolean true

是否开启高可用集群,取值如下:

  • true:开启高可用集群。如果开启高可用,需要两台Master节点。
  • false:不开启高可用集群。
UseLocalMetaDb Boolean true

是否使用本地Hive元数据库,取值如下:

  • true:使用本地Hive元数据库。
  • false:不本地Hive元数据库。
IoOptimized Boolean true

是否开启I/O优化,取值如下:

  • true:开启I/O优化
  • false:不开启I/O优化
SshEnable Boolean true

是否开启SSH,取值如下:

  • true:开启SSH
  • false:不开启SSH
InstanceGeneration String ecs-3

ECS实例规格。

MasterPwd String pwd

Master节点SSH访问密码。需要满足ECS的密码规则:8~30个字符,且同时包含任意三项(大、小写字母、数字和特殊符号)。

KeyPairName String test_pair

密钥对。

MetaStoreType String local

统一元数据类型,取值如下:

  • local:集群内部元数据
  • unified:统一元数据
  • user_rds:用户自建RDS
MetaStoreConf String rds-xxx.com

统一元数据的配置信息。

ClickHouseConf String

保留字段,无需填写。

ExtraAttributes String

保留字段,无需填写。

HostComponentInfo.N.HostName String emr-header-1

主机名。

HostComponentInfo.N.ServiceName String HDFS

服务名。

HostComponentInfo.N.ComponentNameList.N RepeatList NAMENODE

组件列表。

ServiceInfo.N.ServiceName String HDFS

服务名。

ServiceInfo.N.ServiceVersion String 2.3.3-1.0.2

服务内部版本。

PromotionInfo.N.PromotionOptionNo String

保留字段,无需填写。

PromotionInfo.N.PromotionOptionCode String

保留字段,无需填写。

PromotionInfo.N.ProductCode String

保留字段,无需填写。

DepositType String HALF_MANAGED

集群的托管类型,取值如下:

  • HALF_MANAGED:半托管
  • MANAGED:全托管
MachineType String ECS

机器类型。

HostGroup.N.ClusterId String

保留字段,无需填写。

HostGroup.N.HostGroupId String

保留字段,无需填写。

HostGroup.N.Comment String

保留字段,无需填写。

HostGroup.N.CreateType String

保留字段,无需填写。

HostGroup.N.ChargeType String PostPaid

付费类型。取值如下:

  • PostPaid:按量付费
  • PrePaid:包年包月
HostGroup.N.Period Integer 2

包年包月时间(包月数有1、2、3、4、5、6、7、8、9、12、24、36)。HostGroup.n.ChargeType=PrePaid时,必填。

HostGroup.N.AutoRenew Boolean false

机器组机器是否自动续费,取值如下:

  • true:自动续费
  • false:手动续费
HostGroup.N.VSwitchId String vsw-bp10tvjyc77psy0z5****

虚拟交换机ID。

HostGroup.N.GpuDriver String cuda9

GPU驱动。

BootstrapAction.N.Arg String --a=b

引导操作参数。

BootstrapAction.N.ExecutionTarget String core_group

脚本执行范围。取值如下:

  • 整个集群,传入空值即可
  • 机器组名称
BootstrapAction.N.ExecutionMoment String BEFORE_INSTALL

脚本执行时机,取值如下:

  • BEFORE_INSTALL:服务安装之前执行
  • AFTER_STARTED:服务启动之后执行
BootstrapAction.N.ExecutionFailStrategy String FAILED_BLOCKED

脚本失败执行策略,取值如下:

  • FAILED_BLOCKED:失败后工作流转人工处理
  • FAILED_CONTINUE:失败后继续执行
UseCustomHiveMetaDB Boolean false

保留字段,无需填写。

InitCustomHiveMetaDB Boolean false

保留字段,无需填写。

Config.N.Encrypt String 0

保留字段,无需填写。

Config.N.Replace String 0

保留字段,无需填写。

Configurations String 0

保留字段,无需填写。

EasEnable Boolean false

是否高安全集群,取值如下:

  • true:高安全集群
  • false:非高安全集群
RelatedClusterId String C-D7958B72E59B****

当前集群是Gateway时,其关联的主集群ID。

WhiteListType String IP

白名单类型,取值如下:

  • IP:IP白名单分组
  • SecurityGroup:安全组
AuthorizeContent String

保留字段,无需填写。

Tag.N.Key String TestKey

EMR实例和节点ECS实例的标签键。N的取值范围:1~20。一旦传入该值,则不允许为空字符串。标签键的取值范围1~128,不能以aliyun和acs:开头,不能包含http://或者https://。

Tag.N.Value String TestValue

EMR实例和节点ECS实例的标签值。N的取值范围:1~20。一旦传入该值,可以为空字符串。标签值的取值范围:1~128,不能以acs:开头,不能包含http://或者https://。

ResourceGroupId String rg-bp67acfmxazb4p****

EMR实例和节点ECS实例所在的企业资源组ID。

返回数据

名称 类型 示例值 描述
ClusterId String C-D7958B72E59B****

集群ID。

CoreOrderId String

Core节点订单ID。

EmrOrderId String

E-MapReduce订单ID。

MasterOrderId String

Master节点订单ID。

RequestId String BF4FBAC6-B03E-4BFB-B6DB-EB53C34F2E22

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateClusterV2
&BootstrapAction.1.Name=name
&BootstrapAction.1.Path=oss://bucket/path
&ClusterType=HADOOP
&Config.1.ConfigKey=fs.trash.interval
&Config.1.ConfigValue=60
&Config.1.FileName=yarn-site
&Config.1.ServiceName=YARN
&EmrVer=EMR-3.15.0
&HostGroup.1.HostGroupType=MASTER
&HostGroup.1.InstanceType=ecs.mn4.2xlarge
&HostGroup.1.NodeCount=2
&Name=bi_hadoop
&RegionId=cn-hangzhou
&UserInfo.1.Password=pwd
&UserInfo.1.UserId=12345
&UserInfo.1.UserName=tom
&<公共请求参数>

正常返回示例

XML格式

<ClusterId>C-4DE6DA872B0E****</ClusterId>
<RequestId>F4DE89FB-7054-475C-B7E2-B9A38152DA7E</RequestId>

JSON格式

{
    "ClusterId": "C-4DE6DA872B0E****",
    "RequestId": "F4DE89FB-7054-475C-B7E2-B9A38152DA7E"
}