动态与公告

产品动态

产品公告

安全公告

产品简介

产品概述

产品优势

产品架构

产品功能

应用场景

约束与限制

技术支持范围

产品发行版

购买指南

EMR on CVM 计费说明

EMR on TKE 计费说明

EMR Serverless HBase 计费说明

快速入门

EMR on CVM 快速入门

EMR on TKE 快速入门

EMR on CVM 操作指南

规划集群

管理权限

配置集群

管理集群

管理服务

监控告警

智能管家

EMR on TKE 操作指南

EMR on TKE 简介

配置集群

管理集群

管理服务

监控运维

应用分析

EMR Serverless HBase 操作指南

EMR Serverless HBase 产品简介

配额与限制

规划实例

管理实例

监控告警

开发指南

EMR 开发指南

Hadoop开发指南

Spark 开发指南

HBASE开发指南

Phoenix on Hbase 开发指南

Hive 开发指南

Presto开发指南

Sqoop 开发指南

Hue 开发指南

Oozie 开发指南

Flume 开发指南

Kerberos 开发指南

Knox 开发指南

Alluxio 开发指南

Kylin 开发指南

Livy 开发指南

Kyuubi 开发指南

Zeppelin 开发指南

Hudi 开发指南

Superset 开发指南

Impala 开发指南

Druid 开发指南

Tensorflow 开发指南

Kudu 开发指南

Ranger 开发指南

Kafka 开发指南

Iceberg 开发指南

StarRocks 开发指南

Flink 开发指南

JupyterLab 开发指南

MLflow 开发指南

实践教程

EMR on CVM 运维实践

数据迁移实践

自定义伸缩实践教程

API 文档

History

Introduction

API Category

Cluster Resource Management APIs

Cluster Services APIs

User Management APIs

Data Inquiry APIs

Scaling APIs

Configuration APIs

Other APIs

Serverless HBase APIs

YARN Resource Scheduling APIs

Making API Requests

Data Types

Error Codes

常见问题

EMR on CVM常见问题

服务等级协议

联系我们

CreateInstance

PDF

聚焦模式

字号

最后更新时间： 2026-03-26 22:26:02

1. API Description

Domain name for API request: emr.intl.tencentcloudapi.com.

This API is used to create an EMR cluster instance.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer

Try it

API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name	Required	Type	Description
Action	Yes	String	Common Params. The value used for this API: CreateInstance.
Version	Yes	String	Common Params. The value used for this API: 2019-01-03.
Region	Yes	String	Common Params. For more information, please see the list of regions supported by the product.
ProductId	Yes	Integer	Product ID. Different product IDs stand for different EMR product versions. Valid range: 51: STARROCKS-V1.4.0 54: STARROCKS-V2.0.0 27: KAFKA-V1.0.0 50: KAFKA-V2.0.0 16: EMR-V2.3.0 20: EMR-V2.5.0 30: EMR-V2.6.0 38: EMR-V2.7.0 25: EMR-V3.1.0 33: EMR-V3.2.1 34: EMR-V3.3.0 37: EMR-V3.4.0 44: EMR-V3.5.0 53: EMR-V3.6.0
Software.N	Yes	Array of String	List of deployed components. The list of component options varies by EMR product ID (i.e., `ProductId`; for specific meanings, please see the `ProductId` input parameter). For more information, please see Component Version. Enter an instance value: `hive` or `flink`.
SupportHA	Yes	Integer	Whether to enable high node availability. Valid values: 0: does not enable high availability of node. 1: enables high availability of node.
InstanceName	Yes	String	Instance name. Length limit: 6-36 characters. Only letters, numbers, dashes (-), and underscores (_) are supported.
PayMode	Yes	Integer	Instance billing mode. Valid values: 0: pay-as-you-go.
TimeSpan	Yes	Integer	Purchase duration of instance, which needs to be used together with `TimeUnit`. When `TimeUnit` is `s`, this parameter can only be filled with 3600, indicating a pay-as-you-go instance. When `TimeUnit` is `m`, the number entered in this parameter indicates the purchase duration of the monthly-subscription instance; for example, 1 means one month
TimeUnit	Yes	String	Time unit of instance purchase duration. Valid values: s: seconds. When `PayMode` is 0, `TimeUnit` can only be `s`. m: month. When `PayMode` is 1, `TimeUnit` can only be `m`.
LoginSettings	Yes	LoginSettings	Instance login settings. This parameter allows you to set the login password or key for your purchased node. If the key is set, the password will be only used for login to the native component WebUI. If the key is not set, the password will be used for login to all purchased nodes and the native component WebUI.
VPCSettings	No	VPCSettings	Configuration information of VPC. This parameter is used to specify the VPC ID, subnet ID, etc.
ResourceSpec	No	NewResourceSpec	Node resource specification.
COSSettings	No	COSSettings	Parameter required for enabling COS access.
Placement	No	Placement	Instance location. This parameter is used to specify the AZ, project, and other attributes of the instance.
SgId	No	String	Security group to which an instance belongs in the format of `sg-xxxxxxxx`. This parameter can be obtained from the `SecurityGroupId` field in the return value of the DescribeSecurityGroups API.
PreExecutedFileSettings.N	No	Array of PreExecuteFileSettings	Bootstrap action script settings
AutoRenew	No	Integer	Whether auto-renewal is enabled. Valid values: 0: auto-renewal not enabled. 1: auto-renewal enabled.
ClientToken	No	String	Unique random identifier with the time efficiency of 5 minutes, which needs to be specified by the caller to prevent the client from creating resources again, for example, a9a90aa6---****-fae36063280.
NeedMasterWan	No	String	Whether to enable public IP access for master node. Valid values: NEED_MASTER_WAN: enables public IP for master node. NOT_NEED_MASTER_WAN: does not enable. Public IP is enabled for master node by default.
RemoteLoginAtCreate	No	Integer	Whether to enable remote public network login, i.e., port 22. When `SgId` is not empty, this parameter does not take effect.
CheckSecurity	No	Integer	Whether to enable secure cluster. 0: no; other values: yes.
ExtendFsField	No	String	Accesses to external file system.
Tags.N	No	Array of Tag	Tag description list. This parameter is used to bind a tag to a resource instance.
DisasterRecoverGroupIds.N	No	Array of String	List of spread placement group IDs. Only one can be specified currently. This parameter can be obtained in the `SecurityGroupId` field in the return value of the DescribeSecurityGroups API.
CbsEncrypt	No	Integer	CBS disk encryption at the cluster level. 0: not encrypted, 1: encrypted
MetaType	No	String	Hive-shared metadatabase type. Valid values: EMR_DEFAULT_META: the cluster creates one by default. EMR_EXIST_META: the cluster uses the specified EMR-MetaDB instance. USER_CUSTOM_META: the cluster uses a custom MetaDB instance.
UnifyMetaInstanceId	No	String	EMR-MetaDB instance
MetaDBInfo	No	CustomMetaInfo	Custom MetaDB instance information
ApplicationRole	No	String	Custom application role.
SceneName	No	String	Scenario-based values: Hadoop-Kudu Hadoop-Zookeeper Hadoop-Presto Hadoop-Hbase
ExternalService.N	No	Array of ExternalService	Shared component information
VersionID	No	Integer	If the value is 0, MultiZone, MultiDeployStrategy, and MultiZoneSettings are disabled. If the value is 1, ResourceSpec is deprecated and MultiZoneSettings is used instead.
MultiZone	No	Boolean	`true` indicates that the multi-AZ deployment mode is enabled. This parameter is available only in cluster creation and cannot be changed after setting.
MultiZoneSettings.N	No	Array of MultiZoneSetting	Node resource specs. The actual number of AZs is set, with the first AZ as the primary AZ, the second as the backup AZ, and the third as the arbitrator AZ. If the multi-AZ mode is not enabled, set the value to `1`.
CosBucket	No	String	COS bucket path, which is used when you create StarRocks compute-storage separation clusters.
NodeMarks.N	No	Array of NodeMark	Node identifier information: currently used only in Terraform.
LoadBalancerId	No	String	CLB id

3. Output Parameters

Parameter Name	Type	Description
InstanceId	String	Instance ID.
RequestId	String	The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Creating an instance

Input Example

POST / HTTP/1.1
Host: emr.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateInstance
<Common request parameters>

{
    "ResourceSpec": {
        "MasterResourceSpec": {
            "StorageType": "5",
            "DiskType": "CLOUD_PREMIUM",
            "Cpu": "4",
            "DiskSize": "100",
            "MemSize": "8192",
            "RootSize": "100",
            "Spec": "CVM.S2"
        },
        "CoreCount": "2",
        "CoreResourceSpec": {
            "StorageType": "5",
            "DiskType": "CLOUD_PREMIUM",
            "Cpu": "4",
            "DiskSize": "100",
            "MemSize": "8192",
            "RootSize": "100",
            "Spec": "CVM.S2"
        },
        "MasterCount": "1"
    },
    "Placement": {
        "ProjectId": "0",
        "Zone": "ap-guangzhou-3"
    },
    &SupportHA=0
    "TimeSpan": "3600",
    "VPCSettings": {
        "SubnetId": "subnet-xxxxxxx",
        "VpcId": "vpc-xxxxxx"
    },
    "LoginSettings": {
        "Password": "tencent@cloud123"
    },
    "PayMode": "0",
    "AutoRenew": "0",
    "TimeUnit": "s",
    "Software": [
        "zookeeper-3.4.9",
        "hadoop-2.8.4",
        "knox-1.2.0"
    ],
    "InstanceName": "emr test",
    "ProductId": "4"
}

Output Example

{
    "Response": {
        "RequestId": "d830face-6587-4263-8ab0-56bda265787d",
        "InstanceId": "emr-xxxx"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

Tencent Cloud CLI 3.0

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code	Description
FailedOperation	Operation failed.
FailedOperation.DuplicateOrderNotAllowed	Duplicate order. Please check the EMR console.
FailedOperation.GetCvmServerFailed	Failed to call the CVM service.
InternalError	Internal error.
InternalError.AccountCgwError	An error occurred while calling another service API.
InternalError.CamCgwError	An error occurred while calling another service API.
InternalError.CamError	An error occurred while calling another service API.
InternalError.CbsCgwError	An error occurred while calling another service API.
InternalError.CbsError	An error occurred while calling another service API.
InternalError.CdbCgwError	An error occurred while calling another service API.
InternalError.CdbError	An error occurred while calling another service API.
InternalError.CheckQuotaErr	CVM or CBS resources are insufficient, or the software is invalid.
InternalError.ConfigCgwError	An error occurred while calling another service API.
InternalError.CvmError	An error occurred while calling another service API.
InternalError.KmsError	An error occurred while calling another service API.
InternalError.ProjectCgwError	An error occurred while calling another service API.
InternalError.SgError	An error occurred when calling a security group API.
InternalError.TagError	An error occurred while calling another service API.
InternalError.TradeCgwError	An error occurred while calling another service API.
InternalError.VpcCgwError	An error occurred while calling another service API.
InternalError.VpcError	An error occurred while calling another service API.
InternalError.WoodServerError	An error occurred while calling another service API.
InvalidParameter	Invalid parameter.
InvalidParameter.HALessMasterCount	Parameter error.
InvalidParameter.IncorrectCommonCount	The number of common nodes is invalid.
InvalidParameter.IncorrectMasterCount	The number of master nodes is invalid.
InvalidParameter.InvalidAutoRenew	Invalid auto-renewal flag.
InvalidParameter.InvalidClientToken	Invalid `ClientToken`.
InvalidParameter.InvalidComponent	Invalid component.
InvalidParameter.InvalidCoreCount	The number of core nodes is invalid.
InvalidParameter.InvalidCosBucket	The CosBucket parameter is invalid.
InvalidParameter.InvalidCosFileURI	The CosFileUri parameter value is invalid.
InvalidParameter.InvalidDiskSize	Invalid disk size.
InvalidParameter.InvalidExtendField	Invalid `CustomConfig`.
InvalidParameter.InvalidInstanceName	Invalid cluster name.
InvalidParameter.InvalidInstanceType	Invalid model.
InvalidParameter.InvalidLoadBalancer	Invalid LoadBalancerId.
InvalidParameter.InvalidLoginSetting	Invalid login settings.
InvalidParameter.InvalidMetaDataJdbcUrl	Invalid metadatabase URL.
InvalidParameter.InvalidMetaType	Invalid metadata table type.
InvalidParameter.InvalidPassword	Invalid password.
InvalidParameter.InvalidPaymode	Invalid billing mode.
InvalidParameter.InvalidPreExecutedFile	Invalid bootstrap script.
InvalidParameter.InvalidProductId	Invalid product ID.
InvalidParameter.InvalidProjectId	Invalid project ID.
InvalidParameter.InvalidResourceSpec	Invalid resource specification.
InvalidParameter.InvalidSecuritySupport	This EMR version does not support the security mode.
InvalidParameter.InvalidSercurityGrpupId	Invalid security group ID.
InvalidParameter.InvalidServiceName	The service name is invalid.
InvalidParameter.InvalidSoftDeployInfo	The `InvalidSoftDeployInfo` parameter is invalid or incorrect.
InvalidParameter.InvalidSoftInfo	Invalid `SoftInfo`.
InvalidParameter.InvalidSoftWare	Incorrect parameter.
InvalidParameter.InvalidSoftWareName	The software name is invalid.
InvalidParameter.InvalidSoftWareVersion	The software version is invalid.
InvalidParameter.InvalidSubnetId	Invalid subnet ID.
InvalidParameter.InvalidSupportHA	Invalid high availability parameter.
InvalidParameter.InvalidTimeSpan	Invalid `timespan`.
InvalidParameter.InvalidTimeUnit	Invalid `TimeUnit`.
InvalidParameter.InvalidUnifyMeta	Invalid unified metadatabase.
InvalidParameter.InvalidVpcId	Invalid VPC ID.
InvalidParameter.InvalidZone	Invalid AZ.
InvalidParameter.NotContainMustSelectSoftware	Invalid parameter. Necessary components are missing.
InvalidParameter.PayModeResourceNotMatch	The billing mode and resource do not match.
InvalidParameter.SoftwareNotInProduct	There is an invalid product component.
InvalidParameter.UngrantedPolicy	The policy is not authorized.
InvalidParameter.UngrantedRole	The role is not authorized.
InvalidParameter.ZoneResourceNotMatch	The AZ and resource do not match.
InvalidParameterValue	Incorrect parameter value.
LimitExceeded.SecurityGroupNumLimitExceeded	The number of security groups exceeds the limit.
MissingParameter	Missing parameter.
ResourceInsufficient.DiskInsufficient	The disk specification is insufficient.
ResourceInsufficient.InstanceInsufficient	The node specification is unsupported or has been sold out.
ResourceNotFound.SubnetNotFound	No corresponding subnet found.
ResourceNotFound.TagsNotFound	No specified tag found.
ResourcesSoldOut	The resources have been sold out.
ResourcesSoldOut.CbsSoldOut	The CBS resources have been sold out.
ResourcesSoldOut.CvmSoldOut	CVM instances have been sold out.
UnknownParameter	Unknown parameter.
UnsupportedOperation	Unsupported operation.

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

弹性 MapReduce