すべてのプロダクト
Search

このプロダクト

    AnalyticDB:CreateDBInstance

    ドキュメントセンター

    AnalyticDB:CreateDBInstance

    最終更新日:Apr 13, 2026

    AnalyticDB for PostgreSQL インスタンスを作成します。

    操作説明

    この操作を呼び出す前に、AnalyticDB for PostgreSQL の課金方法と料金をご確認ください。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    gpdb:CreateDBInstance

    create

    *DBInstance

    acs:gpdb:{#regionId}:{#accountId}:dbinstance/*
    • gpdb:EncryptionType
    • gpdb:SSLEnabled
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    インスタンスのリージョン ID。

    説明

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

    cn-hangzhou
    ZoneId

    string

    必須

    インスタンスのゾーン ID。

    説明

    DescribeRegions 操作を呼び出して、利用可能なゾーンの ID をクエリできます。

    cn-hangzhou-i
    EngineVersion

    string

    必須

    データベースエンジンバージョン。有効な値：

    • 6.0

    • 7.0

    6.0
    Engine

    string

    必須

    データベースエンジン。値を gpdb に設定します。

    gpdb
    DBInstanceClass

    string

    任意

    インスタンスタイプ。詳細については、DBInstanceClass パラメーターの説明をご参照ください。

    説明

    このパラメーターは、予約ストレージモードのインスタンスに必要です。

    gpdb.group.segsdx1
    DBInstanceGroupCount

    string

    任意

    計算グループの数。有効な値：2、4、8、12、16、24、32、64、96、128。

    説明

    このパラメーターは、予約ストレージモードのインスタンスに必要です。

    2
    DBInstanceDescription

    string

    任意

    インスタンスの説明。

    test
    SecurityIPList

    string

    任意

    インスタンスの IP アドレスホワイトリスト。

    値 127.0.0.1 は、すべての外部アクセスをブロックします。インスタンスを作成した後、ModifySecurityIps 操作を呼び出して IP アドレスホワイトリストを変更できます。

    127.0.0.1
    PayType

    string

    任意

    インスタンスの課金方法。有効な値：

    • Postpaid：従量課金。

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

    説明

    • このパラメーターが指定されていない場合、デフォルトの課金方法は従量課金です。

    • 1 年以上のサブスクリプションには割引が適用されます。ビジネスニーズに基づいて課金方法を選択してください。

    Prepaid
    Period

    string

    任意

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

    • Month

    • Year

    説明

    このパラメーターは、サブスクリプションインスタンスに必要です。

    Month
    UsedTime

    string

    任意

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

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

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

    説明

    このパラメーターは、サブスクリプションインスタンスに必要です。

    1
    ClientToken

    string

    任意

    リクエストのべき等性を保証するために使用されるクライアントトークン。詳細については、「べき等性を確保する方法」をご参照ください。

    0c593ea1-3bea-11e9-b96b-88**********
    InstanceNetworkType

    string

    任意

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

    説明

    • VPC のみがサポートされています。

    • このパラメーターが指定されていない場合、デフォルトで VPC が使用されます。

    VPC
    VPCId

    string

    任意

    VPC ID。

    説明

    • このパラメーターは必須です。

    • VPC は RegionId で指定されたリージョンにある必要があります。

    vpc-bp19ame5m1r3oejns****
    VSwitchId

    string

    任意

    vSwitch ID。

    説明

    • このパラメーターは必須です。

    • vSwitch は ZoneId で指定されたゾーンにある必要があります。

    vsw-bp1cpq8mr64paltkb****
    PrivateIpAddress

    string

    任意

    このパラメーターは非推奨です。

    null
    SegStorageType

    string

    任意

    セグメントノードのストレージタイプ。ESSD のみがサポートされています。値を cloud_essd に設定します。

    説明

    このパラメーターは、弾性ストレージモードのインスタンスに必要です。

    cloud_essd
    SegDiskPerformanceLevel

    string

    任意

    ESSD のパフォーマンスレベル。有効な値：

    • pl0：PL0

    • pl1：PL1

    • pl2：PL2

    説明

    • このパラメーターは、セグメントノードのストレージタイプが ESSD の場合にのみ適用されます。

    • このパラメーターが指定されていない場合、デフォルトで pl1 が使用されます。

    pl1
    InstanceSpec

    string

    任意

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

    弾性ストレージモードの高可用性版インスタンスの有効な値：

    • 2C16G

    • 4C32G

    • 16C128G

    弾性ストレージモードのベーシック版インスタンスの有効な値：

    • 2C8G

    • 4C16G

    • 8C32G

    • 16C64G

    サーバーレスインスタンスの有効な値：

    • 4C16G

    • 8C32G

    説明

    このパラメーターは、弾性ストレージモードまたはサーバーレスモードのインスタンスに必要です。

    2C16G
    SegNodeNum

    string

    任意

    計算ノードの数。有効な値：

    • 弾性ストレージモードの高可用性版インスタンスの場合、値は 4 の倍数で、4 から 512 までです。

    • 弾性ストレージモードのベーシック版インスタンスの場合、値は 2 の倍数で、2 から 512 までです。

    • サーバーレスインスタンスの場合、値は 2 の倍数で、2 から 512 までです。

    説明

    このパラメーターは、弾性ストレージモードまたはサーバーレスモードのインスタンスに必要です。

    4
    MasterNodeNum

    string

    任意

    このパラメーターは非推奨です。

    null
    DBInstanceMode

    string

    必須

    インスタンスのリソースモード。有効な値：

    • StorageElastic：弾性ストレージモード

    • Serverless：サーバーレスモード

    • Classic：予約ストレージモード

    説明

    このパラメーターは必須です。

    StorageElastic
    StorageType

    string

    任意

    このパラメーターは非推奨です。

    null
    DBInstanceCategory

    string

    任意

    インスタンスエディション。有効な値：

    • HighAvailability：高可用性版

    • Basic：ベーシック版

    説明

    このパラメーターは、弾性ストレージモードのインスタンスに必要です。

    HighAvailability
    ResourceGroupId

    string

    任意

    インスタンスのリソースグループ ID。

    rg-bp67acfmxazb4p****
    StorageSize

    integer

    任意

    インスタンスのストレージ容量 (GB)。有効な値：50～6000。

    説明

    このパラメーターは、弾性ストレージモードのインスタンスに必要です。

    200
    CreateSampleData

    boolean

    任意

    インスタンス作成後にサンプルデータセットをロードするかどうかを指定します。有効な値：

    • true：サンプルデータセットがロードされます。

    • false：サンプルデータセットはロードされません。

    説明

    このパラメーターが指定されていない場合、サンプルデータセットはロードされません。

    false
    Tag

    array<object>

    任意

    インスタンスに追加するタグ。最大 20 個のタグを追加できます。

    object

    任意

    インスタンスに追加するタグ。最大 20 個のタグを追加できます。

    Key

    string

    任意

    タグキー。次の制限が適用されます：

    • タグキーは空にできません。

    • タグキーの長さは最大 128 文字です。

    • タグキーは aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

    TestKey
    Value

    string

    任意

    タグ値。次の制限が適用されます：

    • タグ値は空にできます。

    • タグ値の長さは最大 128 文字です。

    • タグ値は acs: で始めることはできず、http:// または https:// を含めることはできません。

    TestValue
    ServerlessResource

    integer

    任意

    計算リソースのしきい値 (AnalyticDB コンピューティングユニット (ACU) 単位)。値は 8 の倍数で、8 から 32 の範囲です。デフォルト値は 32 です。

    説明

    このパラメーターは、自動スケジューリングを使用するサーバーレスインスタンスにのみ必要です。

    32
    IdleTime

    integer

    任意

    インスタンスがアイドル状態と見なされるまでの非アクティブ期間 (秒単位)。最小値：60。デフォルト値：600。

    説明

    このパラメーターは、自動スケジューリングを使用するサーバーレスインスタンスにのみ必要です。

    600
    ServerlessMode

    string

    任意

    サーバーレスインスタンスのモード。有効な値：

    • Manual：手動スケジューリング。これはデフォルト値です。

    • Auto：自動スケジューリング。

    説明

    • このパラメーターは、サーバーレスモードのインスタンスにのみ必要です。

    • サーバーレスモードの AnalyticDB for PostgreSQL インスタンスの自動スケジューリングはプレビュー段階です。この機能を使用するには、チケットを送信してホワイトリストに追加される必要があります。

    Auto
    EncryptionType

    string

    任意

    暗号化タイプ。有効な値：

    • NULL：暗号化を無効にします。これはデフォルト値です。

    • CloudDisk：クラウドディスク暗号化を有効にします。このオプションを選択した場合は、EncryptionKey の値も指定する必要があります。

    説明

    クラウドディスク暗号化を有効にした後、無効にすることはできません。

    CloudDisk
    EncryptionKey

    string

    任意

    暗号鍵の ID。

    説明

    EncryptionType が CloudDisk に設定されている場合は、同じリージョン内の暗号鍵の ID を指定する必要があります。それ以外の場合は、このパラメーターを空のままにします。

    0d2470df-da7b-4786-b981-88888888****
    VectorConfigurationStatus

    string

    任意

    ベクトルエンジン最適化を有効にするかどうかを指定します。有効な値：

    • enabled：ベクトルエンジン最適化を有効にします。

    • disabled (デフォルト)：ベクトルエンジン最適化を無効にします。

    説明

    • 主流の分析、データウェアハウス、リアルタイムデータウェアハウスのシナリオでは、ベクトルエンジン最適化を無効にすることを推奨します。

    • AIGC およびベクトル検索のシナリオでは、ベクトルエンジン最適化を有効にすることを推奨します。

    enabled
    MasterCU

    integer

    任意

    コーディネーターノードのリソース。有効な値：

    • 2 CU

    • 4 CU

    • 8 CU

    • 16 CU

    • 32 CU

    説明

    8 CU 以上のコーディネーターノードリソースは課金対象です。

    8 CU
    SrcDbInstanceName

    string

    任意

    クローンするソースインスタンスの ID。

    説明

    DescribeDBInstances 操作を呼び出して、ターゲットリージョン内のすべての AnalyticDB for PostgreSQL インスタンスの詳細 (インスタンス ID を含む) をクエリできます。

    gp-bp***************
    BackupId

    string

    任意

    バックアップセットの ID。

    説明

    DescribeDataBackups 操作を呼び出して、ソースインスタンスのバックアップセット ID をクエリできます。

    1111111111
    EnableSSL

    boolean

    任意

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

    • true：SSL 暗号化が有効になります。

    • false (デフォルト)：SSL 暗号化が無効になります。

    false
    ProdType

    string

    任意

    製品タイプ。有効な値：

    • standard：Standard Edition。

    • cost-effective：Cost-effective Edition。

    説明

    このパラメーターが指定されていない場合、デフォルト値は standard です。

    standard
    DeployMode

    string

    任意

    デプロイモード。有効な値：

    • multiple：マルチ AZ 配置。

    • single：シングル AZ 配置。

    説明

    • このパラメーターが指定されていない場合、デフォルト値は single です。

    • デフォルトは single (シングル AZ 配置) で、現在サポートされている唯一のモードです。

    single
    StandbyZoneId

    string

    任意

    スタンバイゾーンの ID。

    説明

    • このパラメーターは、マルチ AZ 配置にのみ必要です。

    • DescribeRegions 操作を呼び出して、利用可能なゾーンの ID をクエリできます。

    • スタンバイゾーンはプライマリゾーンと異なる必要があります。

    cn-hangzhou-j
    StandbyVSwitchId

    string

    任意

    スタンバイゾーンの vSwitch の ID。

    説明

    • このパラメーターは、マルチ AZ 配置にのみ必要です。

    • vSwitch は StandbyZoneId で指定されたスタンバイゾーンにある必要があります。

    vsw-bp1cpq8mr64paltkb****
    MasterAISpec

    string

    任意

    このパラメーターを使用して、コーディネーターノードを MasterAI ノードとして設定します。

    説明

    • このパラメーターと MasterCU は相互排他です。

    • この機能は一部のリージョンとゾーンでのみ利用可能です。

    • MasterAI ノードは、AnalyticDB for PostgreSQL V7.0 ベーシック版インスタンスでのみサポートされています。

    • すべての可能な値のリストについては、コンソールのコーディネーターノード仕様変更ページをご参照ください。

    ADB.AIMedium.2
    AINodeSpecInfos

    array<object>

    任意

    AI ノード仕様。

    object

    任意

    AI ノード仕様。

    AINodeNum

    string

    任意

    AI ノードの数。

    1
    AINodeSpec

    string

    任意

    AI ノードの仕様。

    ADB.AIMedium.2
    CacheStorageSize

    string

    任意

    サーバーレスインスタンスのキャッシュサイズ (GB)。

    800

    DBInstanceClass パラメーター

    AnalyticDB for PostgreSQL は現在、次の 2 つのインスタンスタイプをサポートしています：

    • 高性能：これらのインスタンスタイプの名前は gpdb.group.segsdx で始まります。優れた I/O 機能を提供します。

    • 大容量：これらのインスタンスタイプの名前は gpdb.group.seghdx で始まります。より大きく、コスト効率の高いストレージを提供します。

    ストレージと計算の要件に基づいてインスタンスタイプを選択してください。

    AnalyticDB for PostgreSQL は、OSS ベースの外部テーブルもサポートしています。gzip を使用して外部ストレージのデータを圧縮できます。ストレージコストをさらに削減するために、リアルタイムコンピューティングに必要のないデータをそこに保存できます。

    次の表に、高性能インスタンスの仕様を示します：


    仕様
    CPU
    メモリ
    ストレージ

    gpdb.group.segsdx1
    1 コア
    8 GB
    80 GB SSD

    gpdb.group.segsdx2
    2 コア
    16 GB
    160 GB SSD

    gpdb.group.segsdx16
    16 コア
    128 GB
    1.28 TB SSD

    次の表に、大容量インスタンスの仕様を示します：


    仕様
    CPU
    メモリ
    ストレージ

    gpdb.group.seghdx4
    4 コア
    32 GB
    2 TB HDD

    gpdb.group.seghdx36
    36 コア
    288 GB
    18 TB HDD

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    5414A4E5-4C36-4461-95FC-************
    DBInstanceId

    string

    インスタンス ID。

    gp-bp12ga6v69h86****
    Port

    string

    このパラメーターは非推奨であり、返されなくなりました。

    DescribeDBInstanceAttribute 操作を呼び出して、インスタンスのポート番号をクエリできます。

    3432
    ConnectionString

    string

    このパラメーターは非推奨であり、返されなくなりました。

    DescribeDBInstanceAttribute 操作を呼び出して、インスタンスの接続文字列をクエリできます。

    gp-bp12ga6v69h86****.gpdb.rds.aliyuncs.com
    OrderId

    string

    注文 ID。

    111111111111

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "5414A4E5-4C36-4461-95FC-************",
  "DBInstanceId": "gp-bp12ga6v69h86****",
  "Port": "3432",
  "ConnectionString": "gp-bp12ga6v69h86****.gpdb.rds.aliyuncs.com",
  "OrderId": "111111111111"
}

    エラーコード

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

    変更履歴

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