Last updated: 2019-11-29 19:44:03


1. API Description

API domain name:

This API creates an EMR instance.

Default API request rate limit: 20 requests/sec.

2. Input Parameters

The following parameters are required for requesting this API, including action-specific parameters and common parameters. For more information about common parameters for all requests, see Common Request Parameters.

Parameter name Required Type Description
Action Yes String Common parameter. The name of this API: CreateInstance
Version Yes String Common parameter. The version of this API: 2019-01-03
Region Yes String Common parameter. For more information, see the list of regions supported by the product.
ProductId Yes Integer Product ID
VPCSettings Yes VPCSettings VPC settings parameter
Software.N Yes Array of String Software list
ResourceSpec Yes ResourceSpec Resource description
SupportHA Yes Integer Support for HA
InstanceName Yes String Instance name
PayMode Yes Integer Billing method
Placement Yes Placement Cluster location information
TimeSpan Yes Integer Time span
TimeUnit Yes String Time unit
LoginSettings Yes LoginSettings Login configuration
ClientToken Yes String Client token
COSSettings No COSSettings COS settings parameter
SgId No String Security group ID
PreExecutedFileSettings No PreExecuteFileSettings Pre-execution script settings
AutoRenew No Integer Auto-renewal
NeedMasterWan No String Whether a public IP is needed. If yes, enter NEED_MASTER_WAN; if no, enter NOT_NEED_MASTER_WAN. NEED_MASTER_WAN by default

3. Output Parameters

Parameter name Type Description
Result CreateInstanceResult Instance creation result
RequestId String The ID of the request. Each request returns a unique ID. The RequestId is required to troubleshoot issues.

4. Examples

Example 1 Create an instance

Input Sample Code
&<Common request parameter>

Output Sample Code

  "Response": {
    "Result": {
      "ClientToken": "jaco1",
      "InstanceName": "jaco2",
      "DealNames": [
    "RequestId": "701453be-7257-40e6-b5fd-4bbb01baae36"

5. Developer Resources

API Explorer

This tool provides various capabilities such as online call, signature verification, SDK code generation, and quick API retrieval that significantly reduce the difficulty of using TencentCloud API.


TencentCloud API 3.0 integrates software development kits (SDKs) that support various programming languages to make it easier for you to call the APIs.

6. Error Codes

The following error codes are API business logic-related. For other error codes, see (/document/api/589/15694#.E5.85.AC.E5.85.B1.E9.94.99.E8.AF.AF.E7.A0.81).

Error Code Description
InternalError Internal error.