调用CreateClusterV2,创建一个E-MapReduce集群。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateClusterV2 | 系统规定参数。取值:CreateClusterV2。 |
BootstrapAction.N.Name | String | 是 | init_script | 引导操作名称。 |
BootstrapAction.N.Path | String | 是 | oss://bucket/path | 引导操作脚本OSS存放路径。 |
ClusterType | String | 是 | HADOOP | 集群类型,取值如下:
|
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.35.0 | EMR版本。 说明 控制台创建集群可查看到EMR版本列表。 |
HostGroup.N.DiskCapacity | Integer | 是 | 80 | 机器组的数据盘容量,单位GB。 |
HostGroup.N.DiskCount | Integer | 是 | 4 | 机器组的数据盘数量。 |
HostGroup.N.DiskType | String | 是 | CLOUD_EFFICIENCY | 机器组的数据盘类型,取值如下:
|
HostGroup.N.HostGroupName | String | 是 | 主实例组 | 机器组名称。 |
HostGroup.N.HostGroupType | String | 是 | MASTER | 机器组类型,取值如下:
说明 MASTER和CORE均只支持设置一个组。 |
HostGroup.N.InstanceType | String | 是 | ecs.g6.2xlarge | 实例规格。更多信息,请参见实例规格族,您也可以调用DescribeInstanceTypes接口获得最新的规格表。 |
HostGroup.N.NodeCount | Integer | 是 | 2 | 机器组节点数。 |
HostGroup.N.SysDiskCapacity | Integer | 是 | 80 | 机器组的系统盘容量,单位GB。 |
HostGroup.N.SysDiskType | String | 是 | CLOUD_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查看阿里云地域下的可用区。 |
SecurityGroupId | String | 否 | sg-bp1id7ajv83kmqwq**** | 安全组ID,可以输入已有安全组ID,如果安全组不存在,将自动创建一个安全组。 说明 参数SecurityGroupId和SecurityGroupName要求不能同时为空。 |
IsOpenPublicIp | Boolean | 否 | true | MASTER节点是否开启公网IP,取值如下:
|
SecurityGroupName | String | 否 | emr-sg | 需要新建的安全组名称。如果不指定安全组ID,那么将使用这个名字创建一个新的安全组。当集群创建完成以后,可以在集群详情中看到创建的安全组ID。这个安全组将会带有默认的安全组策略:出方向开放所有端口。 说明 参数SecurityGroupId和SecurityGroupName要求不能同时为空。 |
ChargeType | String | 否 | PostPaid | 集群付费类型,取值如下:
|
Period | Integer | 否 | 2 | 包年包月时间(包月数有:1、2、3、4、5、6、7、8、9、12、24、36)。当ChargeType为PrePaid时必填。 |
AutoRenew | Boolean | 否 | false | 包年包月集群是否自动续费,取值如下:
|
AutoPayOrder | Boolean | 否 | true | 是否自动付费,当付费类型为PrePay时,该参数才生效,取值如下:
|
VpcId | String | 否 | vpc-bp1l4urd87xlh7i4b**** | VPC ID。 |
VSwitchId | String | 否 | vsw-bp10tvjyc77psy0z5**** | 虚拟交换机ID。 |
NetType | String | 否 | VPC | 网络类型。 取值:VPC。 |
UserDefinedEmrEcsRole | String | 否 | AliyunEmrEcsDefaultRole | 授权给ECS的角色,用于ECS内部访问OSS等其他阿里云服务:
|
OptionSoftWareList.N | RepeatList | 否 | ["ZOOKEEPER","LIVY"] | 支持的可选服务,服务名称需要大写。您可以在EMR控制台创建集群的软件配置页面,查看支持的可选服务。 说明 填写可选组件即可,并且该参数有长度限制,传入的服务名不得超过20个,否则多出的参数会被丢弃。 |
HighAvailabilityEnable | Boolean | 否 | true | 是否开启高可用集群,取值如下:
高可用集群至少2个MASTER节点,未开启高可用集群,无法保证集群高可靠。 |
UseLocalMetaDb | Boolean | 否 | true | 是否使用集群内置MySQL作为Hive元数据库。 取值如下:
集群内置MySQL单节点,无法保证高可靠。 |
MasterPwd | String | 否 | pwd | Master节点root密码。需要满足ECS的密码规则:8~30个字符,且同时包含任意三项(大、小写字母、数字和特殊符号)。 |
KeyPairName | String | 否 | test_pair | 免密登录ECS密钥对。 |
MetaStoreType | String | 否 | local | Hive元数据服务类型,取值如下:
|
MetaStoreConf | String | 否 | {"dbUrl":"jdbc:mysql://rm-xxxxxxxxxx.mysql.rds.aliyuncs.com/hmsdata?createDatabaseIfNotExist=true&characterEncoding=UTF-8","dbUserName":"xxxxxxx","dbPassword":"xxxxxx"} | 统一元数据服务的配置信息,取值如下:
|
ClickHouseConf | String | 否 | 无 | 保留字段,无需填写。 |
ExtraAttributes | String | 否 | 无 | 保留字段,无需填写。 |
HostComponentInfo.N.HostName | String | 否 | emr-header-1 | 组件部署的目标主机名。 |
HostComponentInfo.N.ServiceName | String | 否 | HDFS | 组件所属服务名称。服务名称为大写字母,如HDFS、ZOOKEEPER。 可选服务可从EMR控制台创建集群步骤1-软件配置-服务列表查看获取。 |
HostComponentInfo.N.ComponentNameList.N | RepeatList | 否 | NAMENODE | 组件列表。 |
ServiceInfo.N.ServiceName | String | 否 | HDFS | 服务名称。服务名称为大写字母,如HDFS、ZOOKEEPER。 可选服务可从EMR控制台创建集群步骤1-软件配置-服务列表查看获取。 |
ServiceInfo.N.ServiceVersion | String | 否 | 2.3.3-1.0.2 | 服务内部版本。 |
PromotionInfo.N.PromotionOptionNo | String | 否 | 11080***0000 | 优惠券编码。 |
PromotionInfo.N.PromotionOptionCode | String | 否 | youhui_quan | 优惠券类型,非必填,默认值youhui_quan 。 |
PromotionInfo.N.ProductCode | String | 否 | ecs | 优惠券应用的产品。取值如下:
|
DepositType | String | 否 | HALF_MANAGED | 集群的托管类型,取值:HALF_MANAGED。 半托管表示EMR集群使用的是用户侧ECS或ACK。 |
MachineType | String | 否 | ECS | 集群构建的IaaS层资源类型。 |
HostGroup.N.ClusterId | String | 否 | 无 | 保留字段,无需填写。 |
HostGroup.N.HostGroupId | String | 否 | 无 | 保留字段,无需填写。 |
HostGroup.N.Comment | String | 否 | 无 | 保留字段,无需填写。 |
HostGroup.N.CreateType | String | 否 | 无 | 机器组创建类型,取值如下:
|
HostGroup.N.ChargeType | String | 否 | PostPaid | 付费类型,取值如下:
|
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 | 机器组机器是否自动续费,取值如下:
|
HostGroup.N.VSwitchId | String | 否 | vsw-bp10tvjyc77psy0z5**** | 虚拟交换机ID。 |
HostGroup.N.GpuDriver | String | 否 | cuda9 | GPU驱动。 |
HostGroup.N.PrivatePoolOptionsMatchCriteria | String | 否 | Target | 实例启动的私有池容量选项。弹性保障服务或容量预定服务在生效后会生成私有池容量,供实例启动时选择。取值如下:
|
HostGroup.N.PrivatePoolOptionsId | String | 否 | crp-bp1e4wcvoucrish***** | 私有池ID。即弹性保障服务ID或容量预定服务ID。 |
BootstrapAction.N.Arg | String | 否 | test1 test2 | 引导操作参数. 如果需要传入多个参数,则可以通过空格分隔。例如, 在脚本中即为 |
BootstrapAction.N.ExecutionTarget | String | 否 | core_group | 脚本执行范围。取值如下:
|
BootstrapAction.N.ExecutionMoment | String | 否 | BEFORE_INSTALL | 脚本执行时机,取值如下:
|
BootstrapAction.N.ExecutionFailStrategy | String | 否 | FAILED_BLOCKED | 脚本失败执行策略,取值如下:
|
UseCustomHiveMetaDB | Boolean | 否 | false | 保留字段,无需填写。 |
InitCustomHiveMetaDB | Boolean | 否 | false | 保留字段,无需填写。 |
Config.N.Encrypt | String | 否 | 0 | 保留字段,无需填写。 |
Config.N.Replace | String | 否 | 0 | 保留字段,无需填写。 |
Configurations | String | 否 | 0 | 保留字段,无需填写。 |
EasEnable | Boolean | 否 | false | 集群是否开启高安全,取值如下:
|
RelatedClusterId | String | 否 | C-D7958B72E59B**** | 当前集群是Gateway时,其关联的主集群ID。 |
WhiteListType | String | 否 | IP | 白名单类型,取值如下:
|
AuthorizeContent | String | 否 | 无 | 保留字段,无需填写。 |
Tag.N.Key | String | 否 | Dept | EMR实例和节点ECS实例的标签键。N的取值范围:1~20。一旦传入该值,则不允许为空字符串。标签键的取值范围1~128,不能以aliyun和acs:开头,不能包含http://或者https://。 |
Tag.N.Value | String | 否 | DevIT | EMR实例和节点ECS实例的标签值。N的取值范围:1~20。一旦传入该值,可以为空字符串。标签值的取值范围:1~128,不能以acs:开头,不能包含http://或者https://。 |
ResourceGroupId | String | 否 | rg-bp67acfmxazb4p**** | EMR集群所在的企业资源组ID。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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"
}