All Products
Search

This Product

    E-MapReduce:CreateCluster

    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