调用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"
}