建立一個隨用隨付或者預付費（訂用帳戶）叢集。
介面說明
RunCluster 是 CreateCluster 的升級版本，採用 HTTPS POST 請求，支援更長的參數內容。對於複雜參數，如對象和數組，RunCluster 採用 JSON 格式，使其對 CLI 工具更加友好。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
emr:RunCluster |
create |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
地區 ID。 |
cn-hangzhou |
| ResourceGroupId |
string |
否 |
資源群組 ID。 |
rg-acfmzabjyop**** |
| PaymentType |
string |
否 |
付費類型。取值範圍：
預設值：PayAsYouGo。 |
PayAsYouGo |
| SubscriptionConfig | SubscriptionConfig |
否 |
預付費配置。當 PaymentType 取值為 Subscription 時必填。 |
|
| ClusterType |
string |
是 |
叢集類型。取值範圍：
如果您在 2022 年 12 月 19 日 17 點（UTC+8）以後第一次建立 EMR 叢集，不能選擇 HADOOP、DATA_SCIENCE、PRESTO、ZOOKEEPER 叢集類型。 |
DATALAKE |
| ReleaseVersion |
string |
是 |
EMR 發行版。可通過 EMR 叢集售賣頁面查看 EMR 發行版。 |
EMR-5.16.0 |
| ClusterName |
string |
是 |
叢集名稱。長度為 1~128 個字元，必須以大小字母或中文開頭，不能以 http:// 和 https:// 開頭。可以包含中文、英文、數字、半形冒號（:）、底線（_）、半形句號（.）或者短劃線（-）。 |
emrtest |
| DeployMode |
string |
否 |
叢集中的應用部署模式。取值範圍：
|
HA |
| SecurityMode |
string |
否 |
叢集 Kerberos 安全模式。取值範圍：
|
NORMAL |
| Applications |
array |
是 |
應用列表。數組元素個數 N 的取值範圍：1~100。 |
|
| Application |
否 |
應用。 |
||
| ApplicationConfigs |
array |
否 |
應用配置。數組元素個數 N 的取值範圍：1~1000。 |
|
| ApplicationConfig |
否 |
應用配置。 |
||
| NodeAttributes | NodeAttributes |
否 |
節點屬性。叢集所有 ECS 節點基礎屬性。 |
|
| NodeGroups |
array |
是 |
節點群組配置數組。數組元素個數 N 的取值範圍：1~100。 |
|
| NodeGroupConfig |
否 |
節點群組配置。 |
||
| BootstrapScripts |
array |
否 |
引導指令碼數組。數組元素個數 N 的取值範圍：1~10。 |
|
| Script |
否 |
引導指令碼。 |
||
| Tags |
array |
否 |
標籤。數組元數個數 N 的取值範圍：0~20。 |
|
| Tag |
否 |
標籤。 |
||
| ClientToken |
string |
否 |
等冪用戶端 TOKEN。同一個 ClientToken 多次調用的返回結果一致，同一個 ClientToken 最多隻建立一個叢集。 |
A7D960FA-6DBA-5E07-8746-A63E3E4D**** |
| Description |
string |
否 |
叢集描述。 |
Emr cluster for ETL |
| DeletionProtection |
boolean |
否 |
叢集是否開啟刪除保護。取值範圍：
預設值：false。 |
false |
| Promotions |
array |
否 |
||
|
Promotion |
否 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| ClusterId |
string |
叢集 ID。 |
c-b933c5aac7f7*** |
| OperationId |
string |
操作 ID。 |
op-13c37a77c505**** |
| RequestId |
string |
請求 ID。 |
DD6B1B2A-5837-5237-ABE4-FF0C8944**** |
樣本
正常返回樣本
JSON格式
{
"ClusterId": "c-b933c5aac7f7***",
"OperationId": "op-13c37a77c505****",
"RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 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. | API請求籤名不合法。 |
| 400 | InvalidAction | The action %s requested is invalid. | 不合法的Action。 |
| 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. | 缺少Action參數 |
| 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 | 限流。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內部錯誤。 |
| 404 | ResourceNotFound | The resource not found by %s. | 請求的資源未找到。 |
| 503 | ServiceFailure | The request has failed due to a temporary failure of %s service. | 依賴的阿里雲其他服務不可用。 |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 請求逾時或者服務不可用。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。