Creates a pay-as-you-go or subscription cluster.
Debugging
Authorization information
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| RegionId | string | Yes | The ID of the region in which you want to create the instance. | cn-hangzhou |
| ResourceGroupId | string | No | The ID of the resource group to which to assign the ENI. | rg-acfmzabjyop**** |
| PaymentType | string | No | The billing cycle of the instance. Valid values:
Default value: PayAsYouGo. | PayAsYouGo |
| SubscriptionConfig | SubscriptionConfig | No | The subscription configurations. This parameter is required when the PaymentType parameter is set to Subscription. | |
| ClusterType | string | Yes | The type of the cluster. Valid values:
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 |
| ReleaseVersion | string | Yes | The version of EMR. You can view the EMR release version on the EMR cluster purchase page. | EMR-5.8.0 |
| ClusterName | string | Yes | 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 |
| DeployMode | string | No | The deployment mode of applications in the cluster. Valid values:
| HA |
| SecurityMode | string | No | The security mode of the cluster. Valid values:
| NORMAL |
| Applications | array | Yes | The applications that you want to add to the cluster. Valid values of N: 1 to 100. | |
| Application | Yes | Application. | ||
| ApplicationConfigs | array | No | The configurations of the applications. Valid values of N: 1 to 1000. | |
| ApplicationConfig | No | The configurations of the applications. | ||
| NodeAttributes | NodeAttributes | Yes | The attributes of all Elastic Compute Service (ECS) nodes in the cluster. The basic attributes of all ECS nodes in the cluster. | |
| NodeGroups | array | Yes | The array of configurations of the node groups. Valid values of N: 1 to 100. | |
| NodeGroupConfig | Yes | The configurations of the node group. | ||
| BootstrapScripts | array | No | The array of scripts for the bootstrap actions. Valid values of N: 1 to 10. | |
| Script | No | The boot script. | ||
| Tags | array | No | The tag that you want to add to the cloud desktop. Valid values of N: 0 to 20. | |
| Tag | No | The tag that you want to add to the cloud desktop. | ||
| ClientToken | string | No | 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
Examples
Sample success responses
JSONformat
{
"ClusterId": "c-b933c5aac7f7***",
"OperationId": "op-13c37a77c505****",
"RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}Error codes
| HTTP status code | Error code | Error message |
|---|---|---|
| 400 | OperationDenied | The operation is invalid. %s |
| 400 | OutOfStock | The requested resource is sold out in the specified zone, try other types of resources or other regions and zones. |
| 400 | QuotaExceeded | Request fail due to quota exceed. %s |
| 400 | AccountException | Account exception. %s |
| 400 | ConflictParameters | Parameters that must not be used together. %s |
| 400 | IncompleteSignature | The request signature is invalid. |
| 400 | InvalidAction | The action %s requested is invalid. |
| 400 | InvalidParameter | The specified parameter %s is not valid. |
| 400 | InvalidParameterValue | The input parameter %s is invalid or out of range. |
| 400 | MissingAction | The action %s requested is missing. |
| 400 | MissingParameter | The input parameter %s that is mandatory for processing this request is not supplied. |
| 400 | NotAuthorized | You do not have permission to perform this action. %s |
| 400 | ThrottlingException | The request was denied due to request throttling. %s |
| 404 | ResourceNotFound | The resource not found by %s. |
| 500 | ServiceFailure | The request has failed due to a temporary failure of %s service. |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. |
| 503 | ServiceUnavailable | The 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 time | Summary of changes | Operation | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2023-09-14 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||
| ||||||||||||
| 2023-08-30 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||
| ||||||||||||
| 2023-04-20 | The Error code has changed | see changesets | ||||||||||
|