すべてのプロダクト
Search

このプロダクト

    :CreateDedicatedHost

    ドキュメントセンター

    :CreateDedicatedHost

    最終更新日:Feb 25, 2026

    専用クラスター内にホストを作成します。

    今すぐお試しください

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

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DedicatedHostGroupId

    string

    必須

    専用クラスター ID です。ApsaraDB for MyBase コンソールにログインし、専用クラスターページで専用クラスター ID を確認できます。

    説明

    ホストのデータベースエンジンは、クラスターのデータベースエンジンと同じです。

    dhg-6w7q18iwt5jo****
    HostClass

    string

    必須

    ホストのインスタンスタイプです。異なるデータベースエンジンでサポートされるホストのインスタンスタイプについては、「ホストのインスタンスタイプ」をご参照ください。

    rds.g6.4xlarge
    PayType

    string

    必須

    ホストの課金方法です。prepaid を指定します。

    prepaid
    Period

    string

    任意

    サブスクリプション期間の単位です。有効な値は以下のとおりです。

    • Year

    • Month

    Month
    UsedTime

    string

    任意

    ホストのサブスクリプション期間です。

    • Period が Year の場合、有効な値は 1 ～ 5 です。****

    • Period が Month の場合、有効な値は 1 ～ 9 です。

    1
    ClientToken

    string

    必須

    リクエストのべき等性を保証するためのクライアントトークンです。クライアント側でトークンを生成できますが、異なるリクエスト間で一意となるようにしてください。トークンには ASCII 文字のみを使用でき、長さは 64 文字以内である必要があります。

    ETnLKlblzczshOTUbOCzSBZH8****
    AutoRenew

    string

    任意

    自動更新機能を有効にするかどうかを指定します。有効な値は以下のとおりです。

    • true

    • false

    説明

    このパラメーターを指定しない場合、デフォルト値 false が使用されます。

    false
    ImageCategory

    string

    任意

    ホストのイメージです。有効な値は以下のとおりです。

    • WindowsWithMssqlEntAlwaysonLicense: SQL Server Cluster Edition.

    • WindowsWithMssqlStdLicense: SQL Server Standard Edition.

    • WindowsWithMssqlEntLicense: SQL Server Enterprise Edition.

    • WindowsWithMssqlWebLicense: SQL Server Web Edition.

    • AliLinux: その他のイメージ。

    説明

    SQL Server を実行するホストを作成する場合は、ホストイメージを指定する必要があります。

    AliLinux
    OsPassword

    string

    任意

    ホストのパスワードです。Proprietary MyBase 専用クラスター内のホストを作成する場合にのみ、パスワードを指定できます。

    • パスワードの長さは 8 ～ 30 文字である必要があります。

    • パスワードには、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。

    • 使用可能な特殊文字は次のとおりです：() \ ` ~ ! @ # $ % ^ & * - _ + = | { } [ ] : ; ' < > , . ? /

    Test123456
    HostStorageType

    string

    任意

    ホストのディスクタイプです。このパラメーターは、Tair を実行する専用クラスターに対してのみ有効です。有効な値は以下のとおりです。

    • cloud_essd: PL1 enhanced SSD (ESSD)。

    • cloud_essd0: PL0 ESSD。

    列挙値:

    • cloud_essd0 :

      cloud_essd0

    • cloud_essd :

      cloud_essd

    cloud_essd0
    HostStorage

    string

    任意

    ホストのディスクストレージです。このパラメーターは、Tair を実行する専用クラスターに対してのみ有効です。単位：GB。有効な値は以下のとおりです。

    • 512

    • 1024

    • 1536

    • 2048

    • 2560

    • 3072

    • 3584

    • 4096

    512
    RegionId

    string

    必須

    専用クラスターのリージョン IDです。

    cn-hangzhou
    ZoneId

    string

    必須

    ゾーン ID です。DescribeRegions 操作を呼び出して、最新のゾーンリストを照会できます。

    cn-hangzhou-i
    VSwitchId

    string

    必須

    vSwitch ID です。Virtual Private Cloud (VPC) コンソールで vSwitch ID を確認できます。

    vsw-bp133c8ifzxd3iv6q****
    ClusterType

    string

    任意

    Self-managed MyBase クラスターのデプロイメントタイプです。有効な値は onACK および onECS です。

    onACK
    ClusterAlias

    string

    任意

    Self-managed MyBase クラスターのエイリアスです。

    test-on-ack-cluster
    VpcID

    string

    任意

    Self-managed MyBase クラスターの VPC ID です。

    vpc-xxxxxx
    ClusterServices

    array

    任意

    Elastic Compute Service (ECS) 上の Self-managed MyBase クラスター内のインスタンスに関連付けられたサービスです。

    string

    任意

    Elastic Compute Service (ECS) 上の Self-managed MyBase クラスター内のインスタンスに関連付けられたサービスです。

    "Orchestrator3.2.6,Promethus2.49.1,Grafana10.2.3"
    MyBaseEcsClass

    object

    任意

    Elastic Compute Service (ECS) 上の Self-managed MyBase クラスター内のインスタンスのパラメーターです。

    ChargeType

    string

    任意

    課金方法です。有効な値は以下のとおりです。

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

    • PostPaid: 従量課金。

    PrePaid
    EcsClassCode

    string

    任意

    インスタンスタイプです。

    ecs.g7.large
    Amount

    integer

    任意

    作成するホストの数です。

    1
    Period

    integer

    任意

    ホストのサブスクリプション期間です。ChargeType が PrePaid に設定されている場合、Period パラメーターを指定する必要があります。

    1
    PeriodType

    string

    任意

    サブスクリプション期間の単位です。デフォルト値は Month です。

    Month
    SystemDiskSize

    integer

    任意

    システムディスクのサイズです。単位：GB。

    40
    SystemDiskCategory

    string

    任意

    システムディスクのタイプです。

    cloud_essd
    DataDiskSize

    integer

    任意

    データディスクのサイズです。単位：GB。

    40
    DataDiskCategory

    string

    任意

    データディスクのタイプです。

    cloud_essd
    DataDiskCount

    integer

    任意

    データディスクの数です。

    2
    AutoRenew

    boolean

    任意

    ホストの自動更新を有効にするかどうかを指定します。デフォルト値は false です。

    false
    Password

    string

    任意

    ホストのパスワードです。

    ***********
    KeyPairName

    string

    任意

    キーペアの名前です。

    test****
    SecurityGroupIds

    array

    任意

    インスタンスが属するセキュリティグループの ID です。

    string

    任意

    インスタンスが属するセキュリティグループの ID です。

    sg-uf64zn0tc9qakm2j****
    Tags

    array

    任意

    ホストに追加するタグです。

    string

    任意

    ホストに追加するタグです。

    {\"key1\":\"value1\"}
    InternetMaxBandwidthOut

    integer

    任意

    パブリックアウトバウンドトラフィックの最大帯域幅です。単位：Mbit/s。

    デフォルト値は 0 です。このパラメーターを 0 より大きい値に指定すると、パブリック IP アドレスが自動的に作成されます。

    100
    InternetChargeType

    string

    任意

    ネットワーク使用量の課金方法です。有効な値は以下のとおりです。

    • PayByBandwidth

    • PayByTraffic

    PayByTraffic
    DepolymentSetId

    string

    任意

    デプロイメントセット ID です。

    ****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    OrderId

    integer

    注文 ID です。

    102565235
    RequestId

    string

    リクエスト ID です。

    C860658E-68A6-46C1-AF6E-3AE7C4D32375
    ClusterName

    string

    クラスターの名前です。

    ca-2ze0x527ovq3y****
    DedicateHostList

    object

    DedicateHostList

    array<object>

    作成されたホストです。

    object

    DedicatedHostId

    string

    作成されたホストの ID です。

    ch-bp108dki3wdl6****

    例

    成功レスポンス

    JSONJSON

    {
  "OrderId": 102565235,
  "RequestId": "C860658E-68A6-46C1-AF6E-3AE7C4D32375",
  "ClusterName": "ca-2ze0x527ovq3y****",
  "DedicateHostList": {
    "DedicateHostList": [
      {
        "DedicatedHostId": " ch-bp108dki3wdl6****"
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter The parameter is invalid.
    400 COMMODITY.INVALID_COMPONENT Invalid component.
    400 InvalidAccountPassword.Format The account password format is invalid.
    400 InsufficientResourceCapacity No host is available for the requested instance.

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

    変更履歴

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