All Products
Search

This Product

    E-MapReduce:CreateCluster

    Document Center

    E-MapReduce:CreateCluster

    Last Updated:Oct 17, 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

    There is currently no authorization information disclosed in the API.

    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 is required 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 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 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 service.

    ApplicationConfigsarrayNo

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

    ApplicationConfigApplicationConfigNo

    The service configuration.

    NodeAttributesNodeAttributesYes

    The attributes of all ECS instances. The basic attributes of all ECS instances in the cluster.

    NodeGroupsarrayYes

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

    NodeGroupConfigNodeGroupConfigYes

    The node group.

    BootstrapScriptsarrayNo

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

    ScriptScriptNo

    The bootstrap action.

    TagsarrayNo

    The list of 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****

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