All Products
Search
Document Center

E-MapReduce:CreateCluster

Last Updated:Jan 10, 2024

Creates a pay-as-you-go or subscription cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The ID of the region in which you want to create the instance.

cn-hangzhou
ResourceGroupIdstringNo

The ID of the resource group to which to assign the ENI.

rg-acfmzabjyop****
PaymentTypestringNo

The billing cycle of the instance. Valid values:

  • PayAsYouGo: pay-as-you-go
  • Subscription: subscription

Default value: PayAsYouGo.

PayAsYouGo
SubscriptionConfigSubscriptionConfigNo

The subscription configurations. This parameter is required when the PaymentType parameter is set to Subscription.

ClusterTypestringYes

The type of the cluster. Valid values:

  • DATALAKE: data lake
  • OLAP: online analytical processing (OLAP)
  • DATAFLOW: Dataflow
  • DATASERVING: DataServing
  • CUSTOM: a custom hybrid cluster.
  • HADOOP: the old data lake. We recommend that you use the new data lake.

If you create an EMR cluster for the first time after 17:00 (UTC +8) on December 19, 2022, you cannot select the HADOOP, DATA_SCIENCE, PRESTO, or ZOOKEEPER cluster type.

DATALAKE
ReleaseVersionstringYes

The version of EMR. You can view the EMR release version on the EMR cluster purchase page.

EMR-5.8.0
ClusterNamestringYes

The name of the cluster. The name must be 1 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).

emrtest
DeployModestringNo

The deployment mode of applications in the cluster. Valid values:

  • NORMAL: regular mode. A master node is deployed in the cluster.
  • HA: high availability mode. At least three master nodes are deployed in the cluster.
HA
SecurityModestringNo

The security mode of the cluster. Valid values:

  • NORMAL: regular mode. Kerberos is not enabled.
  • KERBEROS: Kerberos mode. Kerberos is enabled.
NORMAL
ApplicationsarrayYes

The applications that you want to add to the cluster. Valid values of N: 1 to 100.

ApplicationYes

Application.

ApplicationConfigsarrayNo

The configurations of the applications. Valid values of N: 1 to 1000.

ApplicationConfigNo

The configurations of the applications.

NodeAttributesNodeAttributesYes

The attributes of all Elastic Compute Service (ECS) nodes in the cluster. The basic attributes of all ECS nodes in the cluster.

NodeGroupsarrayYes

The array of configurations of the node groups. Valid values of N: 1 to 100.

NodeGroupConfigYes

The configurations of the node group.

BootstrapScriptsarrayNo

The array of scripts for the bootstrap actions. Valid values of N: 1 to 10.

ScriptNo

The boot script.

TagsarrayNo

The tag that you want to add to the cloud desktop. Valid values of N: 0 to 20.

TagNo

The tag that you want to add to the cloud desktop.

ClientTokenstringNo

The idempotent client token. If you call the same ClientToken multiple times, the returned results are the same. Only one cluster can be created with the same ClientToken.

A7D960FA-6DBA-5E07-8746-A63E3E4D****

Response parameters

ParameterTypeDescriptionExample
object

The returned data.

ClusterIdstring

The ID of cluster.

c-b933c5aac7f7***
OperationIdstring

The ID of the operation.

op-13c37a77c505****
RequestIdstring

The ID of the request.

DD6B1B2A-5837-5237-ABE4-FF0C8944****

Examples

Sample success responses

JSONformat

{
  "ClusterId": "c-b933c5aac7f7***",
  "OperationId": "op-13c37a77c505****",
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

Error codes

HTTP status codeError codeError message
400OperationDeniedThe operation is invalid. %s
400OutOfStockThe requested resource is sold out in the specified zone, try other types of resources or other regions and zones.
400QuotaExceededRequest fail due to quota exceed. %s
400AccountExceptionAccount exception. %s
400ConflictParametersParameters that must not be used together. %s
400IncompleteSignatureThe request signature is invalid.
400InvalidActionThe action %s requested is invalid.
400InvalidParameterThe specified parameter %s is not valid.
400InvalidParameterValueThe input parameter %s is invalid or out of range.
400MissingActionThe action %s requested is missing.
400MissingParameterThe input parameter %s that is mandatory for processing this request is not supplied.
400NotAuthorizedYou do not have permission to perform this action. %s
400ThrottlingExceptionThe request was denied due to request throttling. %s
404ResourceNotFoundThe resource not found by %s.
500ServiceFailureThe request has failed due to a temporary failure of %s service.
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.
503ServiceUnavailableThe request has failed due to a temporary failure of the server.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-09-14The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 500
Input ParametersThe request parameters of the API has changed.
    delete Input Parameters: LogCollectStrategy
2023-08-30The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 500
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: LogCollectStrategy
2023-04-20The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 500