You can call this operation to query the details of a cluster template.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description 
Action String Yes DescribeClusterTemplate

The operation that you want to perform. Set the value to DescribeClusterTemplate.

BizId String Yes CT-35498C56B3F1****

The ID of the cluster template.

AccessKeyId String No LTAI8ljWyu7y**

The AccessKey ID provided to you by Alibaba Cloud, which specifies the ID of the user.

Response parameters

Parameter Type Example Description 
RequestId String 29A1D3B7-661C-4FCD-8577-DE93C8F6CA55

The ID of the request.


The information of the cluster template.

AllowNotebook Boolean  false

Indicates whether the Notebook app is allowed.


The list of bootstrap actions.


The information of a bootstrap action.

Arg String --a

The argument that you passed into the bootstrap action.

Name String action_name

The name of the bootstrap action.

Path String oss://bucket/path

The path of the bootstrap action script.

ClusterType String HADOOP

The type of the cluster.


The list of custom configuration items.


The information of a custom configuration item.

ConfigKey String fs.trash.interval

The key of the custom configuration item.

ConfigValue String 60

The value of the custom configuration item.

Encrypt String 0

A reserved parameter.

FileName String yarn-site

The name of the file that contains the custom configuration item.

Replace String 0

A reserved parameter.

ServiceName String YARN

The name of the service that is configured by using the custom configuration items. The name must be capitalized.

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"}}]

The custom configuration items for software. You can use a JSON file to modify the software configurations before you start a cluster.

CreateSource String 2

The method in which the cluster template was created.

DepositType String FULL_MANAGED

The hosting type.

EasEnable Boolean true

Indicates whether the cluster is a high-security cluster.

EmrVer String EMR-3.16.0

The version of E-MapReduce (EMR).

GmtCreate Long 1543765033000

The time when the cluster template was created.

GmtModified Long 1543765033000

The time when the cluster template was modified.

HighAvailabilityEnable Boolean true

Indicates whether the cluster is a high-availability cluster.


The list of host groups.


The information of a host group.

ChargeType String PostPaid

The billing method.

DiskCapacity Integer 80

The data disk capacity of the host group.

DiskCount Integer 4

The number of data disks of the host group.

DiskType String CLOUD_SSD

The data disk type of the host group.

HostGroupId String 0

A reserved parameter.

HostGroupName String Master instance group

The name of the host group.

HostGroupType String MASTER

The type of the host group.

InstanceType String ecs.mn4.2xlarge

The instance type of the host group.

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

The multiple instance types, separated with commas (,).

NodeCount Integer 2

The number of nodes in the host group.

Period String 36

The validity period of the subscription. Unit: days.

SysDiskCapacity Integer 40

The system disk capacity of the host group.

SysDiskType String CLOUD_SSD

The system disk type of the host group.

Id String CT-4A6799A79D73****

The ID of the cluster template.

InitCustomHiveMetaDb Boolean true

A reserved parameter.

InstanceGeneration String ecs-3

The generation of Elastic Compute Service (ECS) instances in the cluster.

IoOptimized Boolean true

Indicates whether ECS instances are I/O optimized.

IsOpenPublicIp Boolean true

Indicates whether a public IP address is assigned.

KeyPairName String test_kp

The name of the Secure Shell (SSH) key pair.

LogEnable Boolean true

Indicates whether Object Storage Service (OSS) logging is enabled.

LogPath String oss//bucketname/path

The path of logs that are stored in OSS buckets.

MachineType String ECS

The type of hosts in the cluster.

MasterNodeTotal Integer 1

The number of master nodes.

MasterPwd String testpd

The password that is used to log on to the master node.

MetaStoreConf String

The configuration information of Hive Metastore.

MetaStoreType String local

The mode in which Hive Metastore is deployed.

NetType String vpc

The network type.

SecurityGroupId String sg-bp1id7ajv83kmqwq2isx

The ID of the security group.

SecurityGroupName String emr_sg

The name of the security group to be created.

SoftwareInfoList ["ZOOKEEPER"]

The list of optional services.


The information of an optional service.

SshEnable Boolean true

Indicates whether the SSH authentication is enabled.

TemplateName String template_name_2

The name of the cluster template.

UseCustomHiveMetaDb Boolean false

A reserved parameter.

UseLocalMetaDb Boolean true

Indicates whether the local Hive metadatabase is used.

UserDefinedEmrEcsRole String AliyunEmrEcsDefaultRole

The RAM role that is assigned to EMR to access ECS resources.

UserId String 125046002175****

The ID of the user.

VSwitchId String vsw-bp10tvjyc77psy0z5****

The ID of the VSwitch.

VpcId String vpc-bp1l4urd87xlh7i4b****

The ID of the VPC to which the cluster belongs.

ZoneId String cn-hangzhou-b

The ID of the zone.


Sample requests

http(s)://[Endpoint]/? Action=DescribeClusterTemplate
&<Common request parameters>

Sample success responses

XML format

			      <hostGroupName>Master instance group</hostGroupName>
			      <hostGroupName>Core instance group</hostGroupName>

JSON format

				"hostGroupName":"Master instance group",
				"hostGroupName":"Core instance group",

Error codes

HTTP status code Error code Error message Description
403 Params.Illegal The specified parameters are wrongly formed.. The error message returned because the format of the specified parameter is invalid.
403 User.OtherUserResource.NotAllow It is not allowed to operate other user's resource The error message returned because you are not allowed to manage resources of other users.
500 InternalError The request processing has failed due to some unknown error. The error message returned because an internal error has occurred. Submit a ticket.

For a list of error codes, visit the API Error Center.