建立一個隨用隨付或者預付費（訂用帳戶）叢集。
介面說明
介面說明
請確保在使用該介面前，已充分瞭解 E-HPC 產品的收費方式和價格。更多資訊，請參見計費概述。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ehpc:CreateCluster |
create |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ClusterName |
string |
否 |
叢集名稱。長度為 2~128 個字元，支援英文、中文和數字。可以包含短劃線（-）和底線（_）。 |
slurm22.05.8-cluster-20240718 |
| ClusterDescription |
string |
否 |
叢集描述。長度為 2~128 個字元，支援英文、中文和數字。可以包含短劃線（-）和底線（_）。 |
slurm22.05.8-cluster-20240718 |
| ClusterCategory |
string |
否 |
叢集系列，取值範圍：
枚舉值：
|
Standard |
| ClusterVpcId |
string |
否 |
叢集使用的Virtual Private Cloud ID。 |
vpc-m5efjevmclc0xdmys**** |
| ClusterVSwitchId |
string |
否 |
叢集使用的虛擬交換器 ID。虛擬交換器 ID 需在 您可以調用 DescribeVpcs 查詢已建立的 VPC 和 VSwitch 資訊。 |
vsw-f8za5p0mwzgdu3wgx**** |
| IsEnterpriseSecurityGroup |
boolean |
否 |
是否使用企業級安全性群組。取值範圍：
關於如何選擇安全性群組類型，請參見普通安全性群組與企業級安全性群組。 枚舉值：
|
false |
| SecurityGroupId |
string |
否 |
指定新建立叢集所屬的安全性群組 ID。 您可以調用 DescribeSecurityGroups 查詢當前地區可以使用的安全性群組。 |
sg-bp13n61xsydodfyg**** |
| ClientVersion |
string |
否 |
叢集用戶端版本。預設使用最新版本。 |
2.1.0 |
| ClusterCustomConfiguration |
object |
否 |
叢集後處理指令碼。 |
|
| Script |
string |
否 |
後處理指令碼的下載地址。 |
http://***** |
| Args |
string |
否 |
安裝後指令碼的執行參數。 |
E-HPC cn-hangzhou |
| ClusterCredentials |
object |
否 |
叢集的安全憑證。 |
|
| KeyPairName |
string |
否 |
金鑰組名稱。長度為 2~128 個英文或中文字元。必須以大小寫字母或中文開頭，不能以 說明
如果您要使用 ECS 金鑰組功能，具體操作，請參見建立金鑰組。 |
ali0824 |
| Password |
string |
否 |
登入節點的 root 密碼。長度為 8 至 20 個字元，必須同時包含大小寫英文字母、數字和特殊符號中的三類字元。特殊符號可以是：
說明
建議使用 HTTPS 協議調用 API 避免密碼泄露。 |
********** |
| MaxCount |
integer |
否 |
叢集可管理的計算節點數量，取值範圍：0～5,000。 |
500 |
| MaxCoreCount |
integer |
否 |
叢集可管理的計算節點總核心數，取值範圍：0～100,000。 |
10000 |
| DeletionProtection |
boolean |
否 |
叢集刪除保護屬性，指定是否支援通過控制台或 API DeleteCluster 刪除叢集。
預設值：false。 枚舉值：
|
false |
| ResourceGroupId |
string |
否 |
資源群組 ID。 您可以調用 ListResourceGroups 查詢資源群組 ID。 |
rg-acfmxazb4****** |
| Tags |
array<object> |
否 |
叢集的標籤列表。 |
|
|
object |
否 |
叢集的標籤資訊。 |
||
| Key |
string |
否 |
叢集的標籤鍵。N 的取值範圍：1~20。一旦傳入該值，則不允許為空白字串。最多支援 128 個字元，不能以 |
ClusterId |
| Value |
string |
否 |
叢集的標籤值。N 的取值範圍：1~20。一旦傳入該值，可以為空白字串。最多支援 128 個字元，不能包含 |
ehpc-hz-****** |
| Manager |
object |
否 |
叢集管理節點配置。 |
|
| Scheduler |
object |
否 |
調度器服務配置資訊。 |
|
| Type |
string |
否 |
調度器類型。取值範圍：
枚舉值：
|
SLURM |
| Version |
string |
否 |
調度器版本。 |
22.05.8 |
| DirectoryService |
object |
否 |
域帳號服務配置資訊。 |
|
| Type |
string |
否 |
域帳號類型。 枚舉值：
|
NIS |
| Version |
string |
否 |
域帳號版本。 |
2.31 |
| DNS |
object |
否 |
網域名稱解析服務配置資訊。 |
|
| Type |
string |
否 |
網域名稱解析類型。 枚舉值：
|
NIS |
| Version |
string |
否 |
網域名稱解析版本。 |
2.31 |
| ManagerNode | NodeTemplate |
否 |
管理節點的硬體設定資訊。 |
|
| Queues |
array |
否 |
叢集隊列的配置。隊列數量支援 0～8 個。 |
|
| QueueTemplate |
否 |
叢集隊列的詳細配置。 |
||
| SharedStorages |
array |
否 |
叢集共用儲存配置。 |
|
| SharedStorageTemplate |
否 |
叢集共用儲存的詳細配置。 |
||
| AdditionalPackages |
array<object> |
否 |
叢集待安裝的軟體列表，N 的取值範圍：0～10。 |
|
|
object |
否 |
待安裝軟體的具體資訊。 |
||
| Name |
string |
否 |
待安裝軟體名稱。 |
mpich |
| Version |
string |
否 |
待安裝軟體版本。 |
4.0.3 |
| Addons |
array<object> |
否 |
叢集自訂服務元件配置，僅支援一個組件。 |
|
|
object |
否 |
自訂服務元件的具體配置資訊。 |
||
| Name |
string |
是 |
自訂服務元件的名稱。 |
Login |
| Version |
string |
是 |
自訂服務元件的版本。 |
1.0 |
| ServicesSpec |
string |
否 |
自訂服務元件的服務配置。 |
"[{\\"ServiceName\\": \\"SSH\\", \\"ServiceAccessType\\": null, \\"ServiceAccessUrl\\": null, \\"NetworkACL\\": [{\\"IpProtocol\\": \\"TCP\\", \\"Port\\": 22, \\"SourceCidrIp\\": \\"0.0.0.0/0\\"}]}, {\\"ServiceName\\": \\"VNC\\", \\"ServiceAccessType\\": null, \\"ServiceAccessUrl\\": null, \\"NetworkACL\\": [{\\"IpProtocol\\": \\"TCP\\", \\"Port\\": 12016, \\"SourceCidrIp\\": \\"0.0.0.0/0\\"}]}, {\\"ServiceName\\": \\"CLIENT\\", \\"ServiceAccessType\\": \\"URL\\", \\"ServiceAccessUrl\\": \\"\\", \\"NetworkACL\\": [{\\"IpProtocol\\": \\"TCP\\", \\"Port\\": 12011, \\"SourceCidrIp\\": \\"0.0.0.0/0\\"}]}]" |
| ResourcesSpec |
string |
否 |
自訂服務元件的資源配置。 |
"{\\"EipResource\\": {\\"AutoCreate\\": true}, \\"EcsResources\\": [{\\"InstanceType\\": \\"ecs.c7.xlarge\\", \\"ImageId\\": \\"centos_7_6_x64_20G_alibase_20211130.vhd\\", \\"SystemDisk\\": {\\"Category\\": \\"cloud_essd\\", \\"Size\\": 40, \\"Level\\": \\"PL0\\"}, \\"EnableHT\\": true, \\"InstanceChargeType\\": \\"PostPaid\\", \\"SpotStrategy\\": \\"NoSpot\\"}]}" |
| ClusterMode |
string |
否 |
叢集部署類型，取值範圍：
枚舉值：
|
Integrated |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| Success |
boolean |
請求結果，可能值：
|
true |
| RequestId |
string |
請求 ID。 |
F6757FA4-8FED-4602-B7F5-3550C0****** |
| ClusterId |
string |
叢集 ID。 |
ehpc-hz-FYUr****** |
| TaskId |
string |
任務 ID。 |
F6757FA4-8FED-4602-B7F5-3550C0****** |
樣本
正常返回樣本
JSON格式
{
"Success": true,
"RequestId": "F6757FA4-8FED-4602-B7F5-3550C0******",
"ClusterId": "ehpc-hz-FYUr******",
"TaskId": "F6757FA4-8FED-4602-B7F5-3550C0******\n"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidParams | The specified parameter %s is invalid. | 指定的參數 %s 無效。 |
| 400 | OrderError.Arrearage | Your account balance is less than CNY 100. Please add funds to your account and try again. | 賬戶餘額不足100元，請您先儲值後再重試。 |
| 400 | OrderError.InstHasUnpaidOrder | Your account has an unpaid order. | 賬戶存在未支付訂單，請您先支付後再重試。 |
| 400 | OrderError.InsufficientBalance | The account balance is insufficient. Please add funds first and try again. | 賬戶已欠費，請您先儲值後再重試。 |
| 400 | OrderError.InvalidPayMethod | No valid default payment method is specified for your account. | 沒有有效預設支付方式，請您查看支付方式是否正確。 |
| 400 | OrderError.NoCard | No credit card is bound to your account. | 未綁定卡，請您先綁定後再重試。 |
| 400 | OrderError.NoRealNameAuthentication | You have not completed the real name authentication. | 未完成實名驗證，請您先進行實名認證後重試。 |
| 400 | OrderError.NoRealNameRegistration | Real name registration is required for instances launched in mainland China. | 國際站使用者購買中國內地地區雲產品，未完成實名註冊。 |
| 400 | OrderError.UserProfileIncomplete | You have not completed your user profile. | 國際站使用者未完善個人資訊。 |
| 400 | Cluster.NotSupported | Current cluster does not support this operation. | 當前叢集不支援該操作。 |
| 403 | ConflictOpt | A conflicting operation is running. | 有衝突的操作在執行中，請您稍後再試。 |
| 403 | TooManyClusters | The number of user clusters exceeds the quota. | 使用者叢集數量超過配額限制，如需更多，請參考產品使用限制文檔的方式提升配額。 |
| 404 | KeyPairNotFound | The specified KeyPair does not exist. | 指定的金鑰組不存在，請您檢查該參數是否正確。 |
| 404 | ImageNotFound | The specified image does not exist. | 指定的鏡像不存在，請您檢查該參數是否正確。 |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server | 請求失敗，服務暫時不可用 |
| 406 | DbError | A database service error occurred. | 資料庫請求失敗 |
| 406 | OrderError | An order request error occurred. | 訂單請求失敗 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。