调用ModifyClusterTemplate接口,修改集群模版。

调试

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

请求参数

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

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

BizId String CT-4A6799A79D73****

集群模版ID。

BootstrapAction.N.Name String action_name

引导操作名。

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

引导操作脚本路径。

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.15.0

EMR版本。

HostGroup.N.DiskCapacity Integer 80

机器组的数据盘容量。

HostGroup.N.DiskCount Integer 4

机器组的数据盘数量。

HostGroup.N.DiskType String CLOUD_SSD

机器组的数据盘类型。

HostGroup.N.HostGroupName String 主实例组

机器组名字。

HostGroup.N.HostGroupType String MASTER

机器组类型。

HostGroup.N.InstanceType String ecs.mn4.2xlarge

机器组型号。

HostGroup.N.NodeCount Integer 4

机器组节点数。

HostGroup.N.SysDiskCapacity Integer 80

机器组的系统盘容量。

HostGroup.N.SysDiskType String CLOUD_SSD

机器组的系统盘类型。

RegionId String cn-hangzhou

区域ID。

TemplateName String new_template_name

集群模版名。

ZoneId String cn-hangzhou-b

可用区ID。

LogPath String oss//bucketname/path

OSS日志路径。

SecurityGroupId String sg-bp1id7ajv83kmqwq****

安全组ID。

IsOpenPublicIp Boolean true

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

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

安全组名字。

ChargeType String PostPaid

付费类型,取值如下:

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

机器组的包年包月时间(包月数有1、2、3、4、5、6、7、8、9、12、24、36)。

AutoRenew Boolean false

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

  • 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

保留字段。

MasterPwd String pwd

Master节点SSH访问密码。

KeyPairName String test_kp

密钥对名称。

MetaStoreType String local

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

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

统一元数据配置信息。

HostGroup.N.HostGroupId String 0

保留字段。

HostGroup.N.ClusterId String 0

保留字段。

HostGroup.N.Comment String comment

保留字段。

HostGroup.N.CreateType String ON_DEMAND

保留字段。

HostGroup.N.ChargeType String PostPaid

付费类型。取值如下:

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

机器组的包年包月时间(包月数有1、2、3、4、5、6、7、8、9、12、24、36)。

HostGroup.N.AutoRenew Boolean true

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

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

交换机ID。

HostGroup.N.MultiInstanceTypes String ecs.sn1.xlarge,ecs.sn2.xlarge

多规格机器型号列表,使用逗号(,)隔开。

BootstrapAction.N.Arg String --a

引导操作参数。

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:失败后继续执行
Configurations String [{"classification": "core-site","properties": {"fs.trash.interval": "61"}},{"classification": "hadoop-log4j","properties": {"hadoop.log.file": "hadoop1.log","hadoop.root.logger": "INFO","a.b.c": "ABC"}}]

软件自定义配置。(集群启动前,可以指定一个JSON文件修改软件配置。)

EasEnable Boolean true

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

  • true:高安全集群
  • false:非高安全集群
DepositType String HALF_MANAGED

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

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

保留字段。

UseCustomHiveMetaDb Boolean false

保留字段。

InitCustomHiveMetaDb Boolean false

保留字段。

Config.N.Encrypt String 0

保留字段。

Config.N.Replace String 0

保留字段。

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。

返回数据

名称 类型 示例值 描述
ClusterTemplateId String CT-4A6799A79D73****

集群模版ID。

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

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyClusterTemplate
&BizId=CT-4A6799A79D73****
&BootstrapAction.1.1ame=action_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.1odeCount=4
&RegionId=cn-hangzhou
&TemplateName=new_template_name
&<公共请求参数>

正常返回示例

XML格式

<ClusterTemplateId>CT-4A6799A79D73****</ClusterTemplateId>
<RequestId>BF4FBAC6-B03E-4BFB-B6DB-EB53C34F2E22</RequestId>

JSON格式

{
  "ClusterTemplateId": "CT-4A6799A79D73****",
  "RequestId":"BF4FBAC6-B03E-4BFB-B6DB-EB53C34F2E22"
}