すべてのプロダクト
Search

このプロダクト

    AnalyticDB:CreateDBCluster

    ドキュメントセンター

    AnalyticDB:CreateDBCluster

    最終更新日:Apr 08, 2026

    データウェアハウスクラスターを作成します。

    操作説明

    注意事項

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    adb:CreateDBCluster

    create

    DBCluster

    acs:adb:{#regionId}:{#accountId}:dbcluster/*
    • adb:DiskEncryption
    • adb:EnableSSL
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID。

    説明

    DescribeRegions 操作を呼び出して、利用可能なリージョンの ID を照会できます。

    cn-hangzhou
    ZoneId

    string

    任意

    アベイラビリティゾーン ID。

    説明

    DescribeRegions 操作を呼び出して、利用可能なアベイラビリティゾーンの ID を照会できます。

    cn-hangzhou-h
    DBClusterVersion

    string

    必須

    AnalyticDB for MySQL クラスターのバージョン。値を 3.0 に設定します。

    3.0
    DBClusterCategory

    string

    必須

    クラスターのエディション。有効な値：

    • Cluster：予約済みクラスター。

    • MixedStorage：エラスティッククラスター (新規)。

    説明

    DBClusterCategory を Cluster に設定した場合は、Mode パラメーターを Reserved に設定する必要があります。DBClusterCategory を MixedStorage に設定した場合は、Mode パラメーターを Flexible に設定する必要があります。そうでない場合、クラスターの作成は失敗します。

    Cluster
    DBClusterClass

    string

    任意

    クラスターの仕様。有効な値：

    • C8

    • C32

    説明

    このパラメーターは、Mode が Reserved (予約モード) に設定されている場合に必須です。

    C8
    DBNodeGroupCount

    string

    任意

    ノードグループの数。値は 1 から 200 までの整数である必要があります。

    説明

    このパラメーターは、Mode が Reserved (予約モード) に設定されている場合に必須です。

    2
    DBNodeStorage

    string

    任意

    ノードのストレージ容量。単位：GB。有効な値はクラスターの仕様によって異なります：

    • C8 仕様の場合、値の範囲は 100 から 1,000 です。

    • C32 仕様の場合、値の範囲は 100 から 8,000 です。

    説明

    • このパラメーターは、Mode が Reserved (予約モード) に設定されている場合に必須です。

    • ストレージサイズが 1,000 GB 未満の場合は 100 の倍数、1,000 GB 以上の場合は 1,000 の倍数である必要があります。

    200
    DBClusterNetworkType

    string

    必須

    クラスターのネットワークタイプ。値を VPC に設定します。

    VPC
    DBClusterDescription

    string

    任意

    クラスターの説明。

    • 説明は http:// または https:// で始めることはできません。

    • 説明は 2～256 文字である必要があります。

    test
    PayType

    string

    必須

    クラスターの課金方法。有効な値：

    • Postpaid：従量課金。

    • Prepaid：サブスクリプション。

    Postpaid
    Period

    string

    任意

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

    • Year

    • Month

    説明

    このパラメーターは、PayType が Prepaid (サブスクリプション) に設定されている場合に必須です。

    Year
    UsedTime

    string

    任意

    サブスクリプション期間。有効な値：

    • Period が Year の場合、値は 1、2、3、または 5 です。

    • Period が Month の場合、値は 1 から 11 までの整数です。

    説明

    • このパラメーターは、PayType が Prepaid (サブスクリプション) に設定されている場合に必須です。

    • サブスクリプション期間が長いほど、割引率が高くなります。たとえば、1 年間のサブスクリプションは、10 か月または 11 か月のサブスクリプションよりも費用対効果が高くなります。

    1
    VPCId

    string

    任意

    Virtual Private Cloud (VPC) の ID。

    vpc-bp1at5ze0t5u3xtqn****
    VSwitchId

    string

    任意

    vSwitch の ID。

    vsw-bp1aadw9k19x6cis9****
    ClientToken

    string

    任意

    リクエストのべき等性を保証するためのクライアント生成トークン。トークンはリクエスト間で一意である必要があり、大文字と小文字が区別され、最大 64 ASCII 文字です。

    123e4567-e89b-12d3-a456-t7241****
    ExecutorCount

    string

    任意

    このパラメーターは予約済みです。

    无
    ResourceGroupId

    string

    任意

    リソースグループの ID。

    rg-4690g37929****
    Tag

    array<object>

    任意

    タグのリスト。

    object

    任意

    Key

    string

    任意

    タグキー。タグを使用してクラスターをフィルターできます。最大 20 個のタグを指定できます。Tag.N.Key の N は、1 から始まる一意の連続した整数である必要があります。Tag.N.Key は Tag.N.Value とペアになります。

    説明

    タグキーは最大 64 文字で、aliyun、acs:、http://、または https:// で始めることはできません。

    tag1
    Value

    string

    任意

    タグ値。タグを使用してクラスターをフィルターできます。最大 20 個のタグを指定できます。Tag.N.Value の N は、1 から始まる一意の連続した整数である必要があります。Tag.N.Value は Tag.N.Key とペアになります。

    説明

    タグ値は最大 64 文字で、aliyun、acs:、http://、または https:// で始めることはできません。

    test1
    Mode

    string

    任意

    クラスターモード。有効な値：

    • Reserved：予約モード。

    • Flexible：フレキシブルモード。

    Reserver
    StorageResource

    string

    任意

    このパラメーターは予約済みです。

    无
    StorageType

    string

    任意

    このパラメーターは予約済みです。

    无
    ComputeResource

    string

    任意

    クラスターのコンピューティングリソース。コンピューティングリソースはデータクエリに使用されます。コンピューティングリソースが多いほど、クエリパフォーマンスが向上します。コンピューティングリソースは、クラスター版とシングルノード版で利用できます：

    • クラスター版：16 コア/64 GB、24 コア/96 GB、32 コア以上の仕様が含まれます。クラスター版は、リソースプールの分離、スケジュールされたスケーリング、ホットデータとコールドデータの階層化ストレージをサポートします。

    • シングルノード版：8 コア/32 GB、16 コア/64 GB などの仕様が含まれます。シングルノード版は SLA 保証を提供せず、障害からの回復時間が長くなります (4～8 時間)。本番環境でシングルノード版を使用することは推奨しません。

    説明

    • DescribeAvailableResource 操作を呼び出して、特定のリージョンで利用可能なコンピューティングリソースを照会できます。

    • このパラメーターは、Mode が Flexible (フレキシブルモード) に設定されている場合に必須です。

    32Core128GBNEW
    RestoreType

    string

    任意

    このパラメーターは予約済みです。

    无
    SourceDBInstanceName

    string

    任意

    このパラメーターは予約済みです。

    无
    BackupSetID

    string

    任意

    このパラメーターは予約済みです。

    无
    RestoreTime

    string

    任意

    このパラメーターは予約済みです。

    无
    ElasticIOResource

    string

    任意

    Elastic IO Unit (EIU) の数。詳細については、「EIU の詳細」をご参照ください。

    0
    DiskEncryption

    boolean

    任意

    ディスク暗号化を有効にするかどうかを指定します。有効な値：

    • true：ディスク暗号化を有効にします。

    • false：ディスク暗号化を無効にします。

    true
    KmsId

    string

    任意

    ディスク暗号化に使用される Key Management Service (KMS) キーの ID。このパラメーターは、DiskEncryption が true に設定されている場合にのみ有効です。

    xxxxxxxx-xxxx-xxxx-xxxx-xxxx
    EnableSSL

    boolean

    任意

    SSL 暗号化を有効にするかどうかを指定します。有効な値：

    • true：SSL 暗号化を有効にします。

    • false：SSL 暗号化を無効にします。

    true

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    1AD222E9-E606-4A42-BF6D-8A4442913CEF
    ResourceGroupId

    string

    リソースグループの ID。

    rg-4690g37929****
    DBClusterId

    string

    DB クラスターの ID。

    am-bp1r053byu48p****
    OrderId

    string

    注文 ID。

    202353278****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "ResourceGroupId": "rg-4690g37929****",
  "DBClusterId": "am-bp1r053byu48p****",
  "OrderId": "202353278****"
}

    エラーコード

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

    変更履歴

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