すべてのプロダクト
Search
ドキュメントセンター

Elastic High Performance Computing:CreateCluster

最終更新日:Dec 21, 2025

従量課金またはサブスクリプションの E-HPC クラスターを作成します。

操作説明

Elastic High Performance Computing (E-HPC) クラスターを作成すると、使用したクラスターリソースに対して課金されます。事前に E-HPC の課金方法を理解しておくことを推奨します。詳細については、「課金概要」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ehpc:CreateCluster

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ZoneId

string

任意

リソースが存在するゾーンの ID。

ListRegions および DescribeZones 操作を呼び出して、E-HPC がサポートされているゾーンの ID をクエリできます。

cn-hangzhou-b

Name

string

必須

E-HPC クラスターの名前。名前の長さは 2~64 文字である必要があります。

test

Description

string

任意

E-HPC クラスターの説明。説明の長さは 2~256 文字で、http:// または https:// で始めることはできません。

TestDescription

EhpcVersion

string

任意

E-HPC のバージョン。デフォルトでは、パラメーターは最新のバージョン番号に設定されます。

1.0.0

ClientVersion

string

任意

E-HPC クライアントのバージョン。デフォルトでは、パラメーターは最新のバージョン番号に設定されます。

ListCurrentClientVersion 操作を呼び出して、E-HPC クライアントの最新バージョンをクエリできます。

1.0.64

OsTag

string

任意

イメージのオペレーティングシステムのタグ。

CentOS_7.2_64

AccountType

string

任意

ドメインアカウントサービスの種類。有効値:

  • nis

  • ldap

デフォルト値:nis。

nis

Domain

string

任意

オンプレミス E-HPC クラスターのドメイン名。

このパラメーターは、`AccountType` パラメーターが `ldap` に設定されている場合にのみ有効です。

ldap

SchedulerType

string

任意

スケジューラの種類。有効値:

  • pbs

  • slurm

  • opengridscheduler

  • deadline

デフォルト値:pbs。

pbs

SecurityGroupId

string

任意

E-HPC クラスターが属するセキュリティグループの ID。

DescribeSecurityGroups 操作を呼び出して、現在のリージョンで利用可能なセキュリティグループをクエリできます。

sg-bp13n61xsydodfyg****

SecurityGroupName

string

任意

既存のセキュリティグループを使用しない場合は、このパラメーターを新しいセキュリティグループの名前に設定します。新しいセキュリティグループにはデフォルトのポリシーが適用されます。

ehpc-SecurityGroup

VpcId

string

任意

E-HPC クラスターが属する VPC の ID。

DescribeVpcs 操作を呼び出して、利用可能な VPC をクエリできます。

vpc-b3f3edefefeep0760yju****

VSwitchId

string

任意

vSwitch ID。E-HPC は VPC ネットワークのみをサポートします。

DescribeVSwitches 操作を呼び出して、利用可能な vSwitch をクエリできます。

vsw-bp1lfcjbfb099rrjn****

VolumeType

string

任意

共有ストレージの種類。値を nas に設定します。これは NAS ファイルシステムを示します。

nas

VolumeId

string

任意

NAS ファイルシステムの ID。このパラメーターを空のままにすると、デフォルトでパフォーマンス最適化 NAS が作成されます。

ListFileSystemWithMountTargets 操作を呼び出して、利用可能なマウントポイントをクエリできます。

008b64****

VolumeProtocol

string

任意

NAS ファイルシステムで使用されるプロトコルの種類。有効値:

  • NFS

  • SMB

デフォルト値:NFS。

NFS

VolumeMountpoint

string

任意

NAS ファイルシステムのマウントポイント。マウントポイントは VPC タイプです。次の情報にご注意ください:

  • `VolumeId` パラメーターが指定されていない場合、`VolumeMountpoint` パラメーターは空のままにできます。この場合、マウントポイントはデフォルトで作成されます。

  • `VolumeId` パラメーターが指定されている場合、`VolumeMountpoint` パラメーターは必須です。ListFileSystemWithMountTargets 操作を呼び出して、利用可能なマウントポイントをクエリできます。

008b648bcb-s****.cn-hangzhou.nas.aliyuncs.com

VolumeMountOption

string

任意

`mount` コマンドを実行してマウントする NFS ファイルシステムのマウントオプション。

詳細については、「Linux ECS インスタンスへの NFS ファイルシステムのマウント」をご参照ください。

-t nfs -o vers=4

RemoteDirectory

string

任意

NAS ファイルシステムがマウントされるリモートディレクトリ。

NasMountpoint:/RemoteDirectory

DeployMode

string

任意

E-HPC クラスターがデプロイされるモード。有効値:

  • Standard:アカウントノード、スケジューリングノード、ログインノード、および複数の計算ノードが個別にデプロイされます。

  • Simple:アカウントノードとスケジューリングノードで構成される管理ノードがデプロイされ、ログインノードと複数の計算ノードは個別にデプロイされます。

  • Tiny:管理ノードと複数の計算ノードがデプロイされます。管理ノードは、アカウントノード、スケジューリングノード、およびログインノードで構成されます。計算ノードは個別にデプロイされます。

デフォルト値:Standard。

Simple

HaEnable

boolean

任意

高可用性機能を有効にするかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

説明

高可用性が有効な場合、プライマリ管理ノードとセカンダリ管理ノードが使用されます。

true

EcsChargeType

string

任意

ノードの課金方法。有効値:

  • PostPaid:従量課金。

  • PrePaid:サブスクリプション。

パラメーターを `PrePaid` に設定すると、デフォルトで自動更新が有効になります。

PostPaid

Password

string

任意

ログインノードの root パスワード。パスワードは 8~30 文字の長さで、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含む必要があります。特殊文字には以下が含まれます:

( ) ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /

`Password` または `KeyPairName` のいずれかを指定する必要があります。両方が指定された場合、`Password` パラメーターが優先されます。

説明

パスワードの漏洩を防ぐため、HTTPS を使用して API 操作を呼び出すことを推奨します。

123****

KeyPairName

string

任意

キーペアの名前。

説明

詳細については、「SSH キーペアの作成」をご参照ください。

test

ImageOwnerAlias

string

任意

イメージの種類。有効値:

  • system:パブリックイメージ

  • self:カスタムイメージ

  • others:共有イメージ

デフォルト値:system。

self

ImageId

string

任意

イメージ ID。

ListImages および ListCustomImages 操作を呼び出して、E-HPC がサポートするイメージをクエリできます。

centos_7_02_64_20G_alibase_20170818****

EcsOrder.Manager.Count

integer

任意

管理ノードの数。有効値:1 および 2。

1

EcsOrder.Manager.InstanceType

string

任意

管理ノードのインスタンスタイプ。

ListPreferredEcsTypes 操作を呼び出して、推奨されるインスタンスタイプをクエリできます。

ecs.n1.tiny

EcsOrder.Compute.Count

integer

任意

クラスター内の計算ノード数。有効値:0~99。

1

EcsOrder.Compute.InstanceType

string

任意

計算ノードのインスタンスタイプ。

ListPreferredEcsTypes 操作を呼び出して、推奨されるインスタンスタイプをクエリできます。

ecs.n1.tiny

EcsOrder.Login.Count

integer

任意

ログインノードの数。有効値:1。

1

EcsOrder.Login.InstanceType

string

任意

ログインノードのインスタンスタイプ。

ListPreferredEcsTypes 操作を呼び出して、推奨されるインスタンスタイプをクエリできます。

ecs.n1.tiny

SccClusterId

string

任意

Super Computing Cluster (SCC) インスタンス ID。

このパラメーターを指定すると、SCC インスタンスは新しい SCC クラスターに移動されます。

00b648b****

ComputeSpotStrategy

string

任意

計算ノードの入札方式。有効値:

  • NoSpot:計算ノードは従量課金インスタンスです。

  • SpotWithPriceLimit:計算ノードは、ユーザー定義の時間単位の最高価格を持つプリエンプティブルインスタンスです。

  • SpotAsPriceGo:計算ノードは、購入時の市場価格が入札価格として使用されるプリエンプティブルインスタンスです。

デフォルト値:NoSpot。

NoSpot

ComputeSpotPriceLimit

string

任意

計算ノードの時間単位の最高価格。パラメーターの値には、小数点以下 3 桁まで使用できます。このパラメーターは、`ComputeSpotStrategy` パラメーターが `SpotWithPriceLimit` に設定されている場合にのみ有効です。

0.034

ComputeEnableHt

boolean

任意

計算ノードのハイパースレッディングを有効にするかどうかを指定します。有効値:

  • true

  • false

デフォルト値:true。

true

Period

integer

任意

サブスクリプションの期間。期間の単位は PeriodUnit パラメーターで指定されます。

  • PriceUnit が Year に設定されている場合の有効値:1、2、3。

  • PriceUnit が Month に設定されている場合の有効値:1、2、3、4、5、6、7、8、9。

  • PriceUnit が Hour に設定されている場合の有効値:1。

デフォルト値:1。

1

PeriodUnit

string

任意

サブスクリプション期間の単位。有効値:

  • Year

  • Month

  • Hour

デフォルト値:Month。

Year

AutoRenew

string

任意

自動更新を有効にするかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

false

AutoRenewPeriod

integer

任意

サブスクリプション計算ノードの自動更新期間。このパラメーターは、`AutoRenew` が `true` に設定されている場合に有効です。

1

InputFileUrl

string

任意

Object Storage Service (OSS) バケットにアップロードされたジョブファイルの URL。

https://ehpc-tianshui.oss-cn-beijing.aliyuncs.com/test-u****/testlist_ehpc.sh

JobQueue

string

任意

計算ノードが追加されるキュー。

workq

SystemDiskType

string

任意

システムディスクの種類。有効値:

  • cloud_efficiency:Ultra ディスク

  • cloud_ssd:標準 SSD

  • cloud_essd:Enhanced SSD (ESSD)

  • cloud:基本ディスク。このタイプのディスクは廃止されました。

デフォルト値:cloud_ssd。

cloud_ssd

SystemDiskSize

integer

任意

システムディスクのサイズ。単位:GB。

有効値:40~500。

デフォルト値:40。

40

RemoteVisEnable

string

任意

VNC を有効にするかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

false

ResourceGroupId

string

任意

リソースグループ ID。

ListResourceGroups 操作を呼び出して、リソースグループの ID を取得できます。

rg-acfmxazb4ph****

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で値が一意であることを確認してください。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。

123e4567-e89b-12d3-a456-426655440000

WithoutElasticIp

boolean

任意

ログインノードが EIP を使用するかどうかを指定します。デフォルト値:false。

有効値:

  • true

  • false

true

SystemDiskLevel

string

任意

システムディスクとして使用される ESSD のパフォーマンスレベル。デフォルト値:PL1。有効値:

  • PL0:ESSD は最大 10,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL1:ESSD は最大 50,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL2:ESSD は最大 100,000 のランダム読み取り/書き込み IOPS を配信できます。

  • PL3:ESSD は最大 1,000,000 のランダム読み取り/書き込み IOPS を配信します。

デフォルト値:PL1。

詳細については、「ESSD」をご参照ください。

PL0

IsComputeEss

boolean

任意

自動スケーリングを有効にするかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

false

ClusterVersion

string

任意

E-HPC クラスターのバージョン。

デフォルト値:1.0。

1.0

Application

array<object>

任意

アプリケーション情報。

object

任意

Tag

string

任意

ソフトウェアのタグ。

N の有効値:0~100。

ListSoftwares 操作を呼び出して、ソフトウェアのタグをクエリできます。

OpenMPI_11.1

AdditionalVolumes

array<object>

任意

NAS ファイルシステムの情報。

array<object>

任意

JobQueue

string

任意

NAS ファイルシステムがアタッチされるノードのキュー。

N の有効値:1~10。

high

VolumeId

string

任意

NAS ファイルシステムの ID。

N の有効値:1~10。

extreme-00b88****

Roles

array<object>

任意

NAS ファイルシステムがアタッチされるノード情報。

object

任意

Name

string

任意

NAS ファイルシステムがアタッチされるノードの種類。

`AdditionalVolumes.N.Roles` の N の有効値:1~10

`Roles.N.Name` の N の有効値:0~8。

["Compute"]

VolumeMountpoint

string

任意

NAS ファイルシステムのマウントポイント。

N の有効値:1~10。

0088****-sihc.cn-hangzhou.extreme.nas.aliyuncs.com

VolumeMountOption

string

任意

NAS ファイルシステムのマウントオプション。

1~10 個の vCPU を指定できます。

-t nfs -o vers=4.0

RemoteDirectory

string

任意

NAS ファイルシステムがマウントされるリモートディレクトリ。

N の有効値:1~10。

/test

VolumeType

string

任意

追加の共有ストレージの種類。NAS ファイルシステムのみがサポートされます。

N の有効値:1~10。

nas

LocalDirectory

string

任意

NAS ファイルシステムがマウントされるローカルディレクトリ。

N の有効値:1~10。

/ff

VolumeProtocol

string

任意

NAS ファイルシステムで使用されるプロトコルの種類。有効値:

  • NFS

  • SMB

N の有効値:1~10。

デフォルト値:NFS。

NFS

Location

string

任意

E-HPC クラスターの種類。値を `PublicCloud` に設定します。

N の有効値:1~10。

PublicCloud

PostInstallScript

array<object>

任意

インストール後のスクリプトの情報。

object

任意

Args

string

任意

クラスター作成後にスクリプトを実行するために使用されるパラメーター。

N の有効値:0~16。

bashfile.sh

Url

string

任意

E-HPC クラスターの作成後にスクリプトをダウンロードするために使用される URL。

N の有効値:0~16

/opt/job.sh

Plugin

string

任意

プラグインのモード構成。このパラメーターは、`SchedulerType` パラメーターが `custom` に設定されている場合にのみ有効です。

値は JSON 文字列である必要があります。パラメーターには、`pluginMod`、`pluginLocalPath`、`pluginOssPath` が含まれます。

  • `pluginMod`:プラグインモード。次のモードがサポートされています:

    • `oss`:プラグインは OSS からダウンロードされ、`pluginLocalPath` パラメーターで指定されたローカルパスに解凍されます。

    • `image`:デフォルトでは、プラグインは `pluginLocalPath` パラメーターで指定された事前定義のローカルパスに保存されます。

  • `pluginLocalPath`:プラグインが保存されるローカルパス。`oss` モードでは共有ディレクトリを、`image` モードでは非共有ディレクトリを選択することを推奨します。

  • `pluginOssPath`:プラグインが OSS に保存されているリモートパス。このパラメーターは、`pluginMod` パラメーターが `oss` に設定されている場合にのみ有効です。

{"pluginMod": "oss","pluginLocalPath": "/opt/plugin","pluginOssPath": "https://bucket.oss-cn-hangzhou.aliyuncs.com/plugin/plugin.tgz"}

WithoutAgent

boolean

任意

エージェントをインストールしないかどうかを指定します。

  • true:エージェントをインストールしません。

  • false:エージェントをインストールします。

デフォルト値:false。

false

WithoutNas

boolean

任意

NAS を共有ストレージとして使用するかどうかを示します。有効値:

  • true:NAS を使用しません。

  • false:NAS を使用します。

デフォルト値:false。

false

RamRoleName

string

任意

Resource Access Management (RAM) ロールの名前。

RAM が提供する ListRoles 操作を呼び出して、作成したインスタンス RAM ロールをクエリできます。

testRamRoleName

NetworkInterfaceTrafficMode

string

任意

ENI の通信モデル。有効値:

  • Standard:TCP 通信モードが使用されます。

  • HighPerformance:Elastic RDMA Interface (ERI) を有効にしたリモートダイレクトメモリアクセス (RDMA) 通信モードを使用します。

Standard

DeploymentSetId

string

任意

インスタンスをデプロイするデプロイメントセットの ID。DescribeDeploymentSets 操作を呼び出すことで、デプロイメントセット ID を取得できます。低レイテンシーポリシーを使用するデプロイメントセットのみがサポートされます。

ds-bp1frxuzdg87zh4pzq****

RamNodeTypes

array

任意

RAM ロールのノード。

Standard

string

任意

RAM ロールのノード。

N の有効値:0~4

  • `DeployMode` パラメーターが `Standard` に設定されている場合、有効な値は `scheduler`、`account`、`login`、`compute` です。複数の値はコンマ (,) で区切ります。

  • `DeployMode` パラメーターが `Simple` に設定されている場合、有効な値は `manager`、`login`、`compute` です。複数の値はコンマ (,) で区切ります。

  • `DeployMode` パラメーターが `Tiny` に設定されている場合、有効な値は `manager` と `compute` です。

manager

Tag

array<object>

任意

タグの配列。

Standard

object

任意

タグの配列。

scheduler

Key

string

任意

タグキー。

TestKey

Value

string

任意

タグ値。

TestValue

AddOns

array<object>

任意

カスタムコンポーネントサービス。

object

任意

Name

string

任意

コンポーネント名。

cromwell

Version

string

任意

コンポーネントのバージョン番号。

85

DeployMode

string

任意

デプロイメントモード。有効値:`local` および `ecs`。

local

DBType

string

任意

データベースエンジンの種類。有効値:`Mysql`、および `null`。

Mysql

ConfigFile

string

任意

設定ファイルのパス。

/usr/local/addon/cromwell/cromwell.conf

Port

number

任意

カスタムコンポーネントのアクセスポート。

10000

DefaultStart

boolean

任意

カスタムコンポーネントを自動起動するかどうかを示します。有効値:`true` および `false`。

true

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

F6757FA4-8FED-4602-B7F5-3550C084****

TaskId

string

タスク ID。

説明

`CreateCluster` は非同期操作です。リクエストが成功するとレスポンスが返されますが、これはクラスターが作成されたことを意味するものではありません。ListTasks 操作を呼び出して、タスクの結果をクエリできます。

F6757FA4-8FED-4602-B7F5-3550C084****

ClusterId

string

クラスター ID。

ehpc-hz-FYUr32****

成功レスポンス

JSONJSON

{
  "RequestId": "F6757FA4-8FED-4602-B7F5-3550C084****",
  "TaskId": "F6757FA4-8FED-4602-B7F5-3550C084****",
  "ClusterId": "ehpc-hz-FYUr32****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParams The specified parameter %s is invalid.
400 NotEnabled You have not enabled this service
400 InDebt Your account has overdue payments.
400 OrderError.InsufficientBalance The account balance is insufficient. Please add funds first and try again.
400 OrderError.InstHasUnpaidOrder Your account has an unpaid order.
400 OrderError.Arrearage Your account balance is less than CNY 100. Please add funds to your account and try again.
400 OrderError.NoCard No credit card is bound to your account.
400 OrderError.InvalidPayMethod No valid default payment method is specified for 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 InvalidVpc The specified VPC is invalid.
400 InvalidVolume The specified volume is invalid.
400 InvalidSoftware The specified software is not supported.
400 InvalidVolumeProtocal The specified volume protocol is invalid.
400 InvalidVolumeMountpoint The specified volume mount point is invalid.
400 MissingParams The %s parameter is required.
500 UnknownError An unknown error occurred.
403 TooManyClusters The number of user clusters exceeds the quota.
403 TooManyComputes The number of computing nodes exceeds the quota.
403 TooManyLogins The maximum number of logged on nodes is exceeded.
403 TooManyScc The maximum number of SCC instances is exceeded.
403 QuotaExceeded.PrivateIpAddress Insufficient private IP addresses in vSwitch: %s.
403 ConflictOpt A conflicting operation is running.
403 ImageNotSupported The specified image is not supported.
404 ImageNotFound The specified image does not exist.
404 VolumeNotFound The specified volume does not exist.
404 VpcNotFound The specified VPC does not exist.
404 KeyPairNotFound The specified KeyPair does not exist.
503 ServiceUnavailable The request has failed due to a temporary failure of the server
406 EcsError An error occurred while calling the ECS API operation.
406 NasError NAS API request failed.
406 NasServiceNotOpen The NAS service is not activated.
406 EipError The EIP API request failed.
406 OrderError An order request error occurred.
406 FailToGenId Generating cluster ID failed.
406 DbError A database service error occurred.
406 AliyunError An Alibaba Cloud product error occurred.
406 AckError An error occurred while calling the ACK API operation.
407 NotAuthorized No authorization is granted.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。