All Products
Search
Document Center

E-MapReduce:CreateCluster

Last Updated:Dec 12, 2024

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

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
emr:CreateClustercreate
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID.

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 takes effect only if you set the PaymentType parameter 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 EMR version. You can query available E-MapReduce (EMR) versions in the EMR console.

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 master nodes in the cluster. Valid values:

  • NORMAL: regular mode. This is the default value. A cluster that contains only one master node is created.
  • HA: high availability (HA) mode. A cluster that contains three master nodes is created.
HA
SecurityModestringNo

The security mode of the cluster. Valid values:

  • NORMAL: disables Kerberos authentication for the cluster. This is the default value.
  • KERBEROS: enables Kerberos authentication for the cluster.
NORMAL
ApplicationsarrayYes

The services. Number of elements in the array: 1 to 100.

ApplicationApplicationYes

The application.

ApplicationConfigsarrayNo

The application configurations. Number of elements in the array: 1 to 1000.

ApplicationConfigApplicationConfigNo

The application configuration.

NodeAttributesNodeAttributesYes

The attributes of all ECS instances.

NodeGroupsarrayYes

The node groups. Number of elements in the array: 1 to 100.

NodeGroupConfigNodeGroupConfigYes

The node group configurations.

BootstrapScriptsarrayNo

The bootstrap actions. Number of elements in the array: 1 to 10.

ScriptScriptNo

The bootstrap action.

TagsarrayNo

The tags. Number of elements in the array: 0 to 20.

TagTagNo

The tag.

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****
DescriptionstringNo

The cluster description.

Emr cluster for ETL

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.
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.
503ServiceFailureThe request has failed due to a temporary failure of %s service.
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
2024-11-28The Error code has changed. The request parameters of the API has changedView Change Details
2024-08-20The Error code has changed. The request parameters of the API has changedView Change Details
2023-09-14The Error code has changed. The request parameters of the API has changedView Change Details
2023-08-30The Error code has changed. The request parameters of the API has changedView Change Details
2023-04-20The Error code has changedView Change Details