全部产品
Search

搜索本产品

    AnalyticDB：CreateDBInstance

    文档中心

    AnalyticDB：CreateDBInstance

    更新时间：Mar 21, 2026

    Buat instans AnalyticDB for PostgreSQL.

    Deskripsi operasi

    Sebelum menggunakan API ini, tinjau Model Harga dan Harga untuk AnalyticDB for PostgreSQL.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    gpdb:CreateDBInstance

    create

    *DBInstance

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

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID Wilayah.

    Catatan

    Anda dapat memanggil operasi DescribeRegions untuk menanyakan wilayah yang tersedia.

    cn-hangzhou
    ZoneId

    string

    Yes

    ID Zona.

    Catatan

    Anda dapat memanggil operasi DescribeRegions untuk menanyakan zona yang tersedia.

    cn-hangzhou-i
    EngineVersion

    string

    Yes

    Versi engine. Nilai yang valid:

    • 6.0: Greenplum 6.0.

    • 7.0: Greenplum 7.0.

    6.0
    Engine

    string

    Yes

    Engine database. Tetapkan nilainya ke gpdb.

    gpdb
    DBInstanceClass

    string

    No

    Tipe instans. Untuk informasi mengenai tipe instans, lihat Tipe instans.

    Catatan

    Parameter ini wajib ditentukan saat Anda membuat instans dalam Mode Penyimpanan Terpesan (Reserved Storage Mode).

    gpdb.group.segsdx1
    DBInstanceGroupCount

    string

    No

    Jumlah kelompok komputasi. Nilai yang valid: 2, 4, 8, 12, 16, 24, 32, 64, 96, dan 128.

    Catatan

    Parameter ini wajib ditentukan saat Anda membuat instans dalam Mode Penyimpanan Terpesan (Reserved Storage Mode).

    2
    DBInstanceDescription

    string

    No

    Deskripsi instans.

    test
    SecurityIPList

    string

    No

    Daftar IP Whitelist instans.

    Nilai 127.0.0.1 menunjukkan bahwa tidak ada alamat IP eksternal yang dapat mengakses instans. Untuk mengubah Daftar IP Whitelist setelah instans dibuat, panggil operasi ModifySecurityIps.

    127.0.0.1
    PayType

    string

    No

    Metode penagihan. Nilai yang valid:

    • Postpaid: Pay-As-You-Go.

    • Prepaid: Subscription.

    Catatan

    • Nilai default adalah Postpaid.

    • Untuk instans Subscription berdurasi satu tahun atau lebih, diskon berlaku.

    Prepaid
    Period

    string

    No

    Unit durasi langganan. Nilai yang valid:

    • Month

    • Year

    Catatan

    Parameter ini wajib ditentukan jika Anda menetapkan PayType ke Prepaid.

    Month
    UsedTime

    string

    No

    Durasi langganan. Nilai yang valid:

    • Jika Period diatur ke Month, nilai yang valid adalah 1 hingga 9.

    • Jika Period diatur ke Year, nilai yang valid adalah 1 hingga 3.

    Catatan

    Parameter ini wajib ditentukan jika Anda menetapkan PayType ke Prepaid.

    1
    ClientToken

    string

    No

    Token client yang menjamin idempotensi permintaan. Untuk informasi selengkapnya, lihat Cara menjamin idempotensi.

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

    string

    No

    Jenis jaringan instans. Tetapkan nilainya ke VPC.

    Catatan

    • Hanya jenis jaringan VPC yang didukung.

    • Jika Anda tidak menentukan parameter ini, VPC digunakan secara default.

    VPC
    VPCId

    string

    No

    ID Virtual Private Cloud (VPC).

    Catatan

    • VPC harus berada di wilayah yang ditentukan oleh RegionId.

    • Wilayah VPC harus sesuai dengan RegionId.

    vpc-bp19ame5m1r3oejns****
    VSwitchId

    string

    No

    ID vSwitch.

    Catatan

    • vSwitch harus berada di zona yang ditentukan oleh ZoneId.

    • Zona untuk vSwitch harus sesuai dengan ZoneId.

    vsw-bp1cpq8mr64paltkb****
    PrivateIpAddress

    string

    No

    Parameter ini sudah tidak digunakan lagi.

    null
    SegStorageType

    string

    No

    Jenis penyimpanan disk. Tetapkan ke cloud_essd, yang menunjukkan Enhanced SSD (ESSD), satu-satunya jenis yang didukung.

    Catatan

    Parameter ini wajib ditentukan saat Anda membuat instans dalam Mode Elastis Penyimpanan (Storage-Elastic Mode).

    cloud_essd
    SegDiskPerformanceLevel

    string

    No

    Tingkat kinerja ESSD. Nilai yang valid:

    • pl0: PL0

    • pl1: PL1

    • pl2: PL2

    Catatan

    • Parameter ini hanya berlaku ketika SegStorageType diatur ke cloud_essd.

    • Nilai default adalah pl1.

    pl1
    InstanceSpec

    string

    No

    Spesifikasi node komputasi.

    Nilai yang valid untuk instans Edisi High-Availability dalam Mode Elastis Penyimpanan:

    • 2C16G

    • 4C32G

    • 16C128G

    Nilai yang valid untuk instans Edisi Dasar dalam Mode Elastis Penyimpanan:

    • 2C8G

    • 4C16G

    • 8C32G

    • 16C64G

    Nilai yang valid untuk instans Mode Serverless:

    • 4C16G

    • 8C32G

    Catatan

    Parameter ini wajib ditentukan saat Anda membuat instans dalam Mode Elastis Penyimpanan atau Mode Serverless.

    2C16G
    SegNodeNum

    string

    No

    Jumlah node komputasi. Nilai yang valid:

    • Untuk instans Edisi High-Availability dalam Mode Elastis Penyimpanan, nilainya harus kelipatan 4, dari 4 hingga 512.

    • Untuk instans Edisi Dasar dalam Mode Elastis Penyimpanan, nilainya harus kelipatan 2, dari 2 hingga 512.

    • Untuk instans Mode Serverless, nilainya harus kelipatan 2, dari 2 hingga 512.

    Catatan

    Parameter ini wajib ditentukan saat Anda membuat instans dalam Mode Elastis Penyimpanan atau Mode Serverless.

    4
    MasterNodeNum

    string

    No

    Parameter ini sudah tidak digunakan lagi.

    null
    DBInstanceMode

    string

    Yes

    Mode instans. Nilai yang valid:

    • StorageElastic: Mode Elastis Penyimpanan.

    • Serverless: Mode Serverless.

    • Classic: Mode Penyimpanan Terpesan (Reserved Storage Mode).

    Catatan

    Parameter ini wajib ditentukan.

    StorageElastic
    StorageType

    string

    No

    Parameter ini sudah tidak digunakan lagi.

    null
    DBInstanceCategory

    string

    No

    Edisi instans. Nilai yang valid:

    • HighAvailability: Edisi High-Availability.

    • Basic: Edisi Dasar.

    Catatan

    Parameter ini wajib ditentukan saat Anda membuat instans dalam Mode Elastis Penyimpanan.

    HighAvailability
    ResourceGroupId

    string

    No

    ID kelompok sumber daya untuk instans.

    rg-bp67acfmxazb4p****
    StorageSize

    integer

    No

    Kapasitas penyimpanan instans. Satuan: GB. Nilainya berkisar antara 50 hingga 6000.

    Catatan

    Parameter ini wajib ditentukan saat Anda membuat instans dalam Mode Elastis Penyimpanan.

    200
    CreateSampleData

    boolean

    No

    Menunjukkan apakah dataset sampel dimuat setelah instans dibuat. Nilai yang valid:

    • true: Memuat dataset sampel.

    • false: Tidak memuat dataset sampel.

    Catatan

    Nilai default adalah false.

    false
    Tag

    array<object>

    No

    Tag yang akan ditambahkan ke instans. Anda dapat menambahkan hingga 20 tag.

    object

    No

    Tag.

    Key

    string

    No

    Kunci Tag. Batasan berikut berlaku:

    • Tidak boleh berupa string kosong.

    • Panjang maksimum: 128 karakter.

    • Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai Tag. Batasan berikut berlaku:

    • Bisa berupa string kosong.

    • Panjang maksimum: 128 karakter.

    • Tidak boleh diawali dengan acs: dan tidak boleh mengandung http:// atau https://.

    TestValue
    ServerlessResource

    integer

    No

    Jumlah sumber daya komputasi dalam AnalyticDB Compute Units (ACUs). Nilainya harus kelipatan 8, dari 8 hingga 32. Nilai default adalah 32.

    Catatan

    Parameter ini hanya wajib untuk instans Serverless yang menggunakan penjadwalan otomatis.

    32
    IdleTime

    integer

    No

    Waktu idle dalam detik sebelum instans dijeda secara otomatis. Nilai minimum adalah 60 dan nilai default adalah 600.

    Catatan

    Parameter ini hanya wajib untuk instans Serverless yang menggunakan penjadwalan otomatis.

    600
    ServerlessMode

    string

    No

    Mode penjadwalan instans Serverless. Nilai yang valid:

    • Manual: penjadwalan manual. Ini adalah nilai default.

    • Auto: penjadwalan otomatis.

    Catatan

    • Parameter ini hanya wajib untuk instans Serverless.

    • Fitur penjadwalan otomatis untuk instans AnalyticDB for PostgreSQL dalam Mode Serverless sedang dalam rilis canary. Untuk menggunakan fitur ini, kirim tiket.

    Auto
    EncryptionType

    string

    No

    Jenis enkripsi. Nilai yang valid:

    • NULL: menonaktifkan enkripsi. Ini adalah nilai default.

    • CloudDisk: Mengaktifkan enkripsi disk. Anda juga harus menentukan EncryptionKey.

    Catatan

    Setelah enkripsi disk diaktifkan, tidak dapat dinonaktifkan.

    CloudDisk
    EncryptionKey

    string

    No

    ID Kunci.

    Catatan

    Parameter ini wajib jika EncryptionType adalah CloudDisk. Kunci tersebut harus berada di wilayah yang sama dengan instans.

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

    string

    No

    Menunjukkan apakah optimisasi mesin vektor diaktifkan. Nilai yang valid:

    • enabled: mengaktifkan optimisasi mesin vektor.

    • disabled: menonaktifkan optimisasi mesin vektor. Ini adalah nilai default.

    Catatan

    • Tetapkan ke disabled untuk skenario analitik utama, gudang data, dan gudang data real-time.

    • Tetapkan ke enabled untuk skenario konten yang dihasilkan AI (AIGC) dan pengambilan vektor yang menggunakan mesin analisis vektor.

    enabled
    MasterCU

    integer

    No

    Sumber daya node koordinator. Nilai yang valid:

    • 2 CU

    • 4 CU

    • 8 CU

    • 16 CU

    • 32 CU

    Catatan

    Biaya berlaku untuk sumber daya node koordinator sebesar 8 CU atau lebih.

    8 CU
    SrcDbInstanceName

    string

    No

    ID instans sumber untuk kloning.

    Catatan

    Anda dapat memanggil operasi DescribeDBInstances untuk menemukan ID semua instans AnalyticDB for PostgreSQL di suatu wilayah.

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

    string

    No

    ID Set Backup.

    Catatan

    Panggil operasi DescribeDataBackups untuk menemukan ID Set Backup untuk suatu instans.

    1111111111
    EnableSSL

    boolean

    No

    Menunjukkan apakah enkripsi SSL diaktifkan. Nilai yang valid:

    • true: mengaktifkan enkripsi SSL.

    • false: menonaktifkan enkripsi SSL. Ini adalah nilai default.

    false
    ProdType

    string

    No

    Jenis produk. Nilai yang valid:

    • standard: Edisi Standar.

    • cost-effective: Edisi Hemat Biaya.

    Catatan

    Nilai default adalah standard.

    standard
    DeployMode

    string

    No

    Mode penerapan. Nilai yang valid:

    • multiple: penerapan multi-zona.

    • single: penerapan zona tunggal.

    Catatan

    • Nilai default adalah single.

    • Saat ini, hanya penerapan zona tunggal yang didukung.

    single
    StandbyZoneId

    string

    No

    ID zona standby.

    Catatan

    • Parameter ini hanya wajib untuk penerapan multi-zona.

    • Anda dapat memanggil operasi DescribeRegions untuk menanyakan ID zona yang tersedia.

    • ID zona standby harus berbeda dari ID zona primer (ZoneId).

    cn-hangzhou-j
    StandbyVSwitchId

    string

    No

    ID vSwitch standby.

    Catatan

    • Parameter ini hanya wajib untuk penerapan multi-zona.

    • vSwitch harus berada di zona yang ditentukan oleh StandbyZoneId.

    vsw-bp1cpq8mr64paltkb****
    MasterAISpec

    string

    No

    Spesifikasi node MasterAI. Jika Anda menentukan parameter ini, node koordinator dikonversi menjadi node MasterAI.

    Catatan

    • Anda tidak dapat menentukan MasterAISpec dan MasterCU secara bersamaan.

    • Fitur ini hanya didukung di wilayah dan zona tertentu.

    • Hanya instans AnalyticDB for PostgreSQL V7.0 dalam Edisi Dasar yang mendukung node MasterAI.

    • Untuk daftar nilai yang valid, lihat halaman konfigurasi instans di Konsol.

    ADB.AIMedium.2
    AINodeSpecInfos

    array<object>

    No

    object

    No

    AINodeNum

    string

    No

    AINodeSpec

    string

    No

    CacheStorageSize

    string

    No

    Parameter DBInstanceClass

    AnalyticDB for PostgreSQL mendukung dua tipe instans berikut:

    • High-Performance: Nama spesifikasi untuk tipe instans ini diawali dengan gpdb.group.segsdx. Tipe instans ini menyediakan kemampuan I/O yang ditingkatkan dan menawarkan kinerja lebih tinggi.

    • High-Capacity: Nama spesifikasi untuk tipe instans ini diawali dengan gpdb.group.seghdx. Tipe instans ini menyediakan kapasitas penyimpanan yang lebih besar dengan biaya lebih hemat.

    Saat memilih tipe instans, pertimbangkan kebutuhan Anda terhadap ruang penyimpanan dan kapasitas komputasi.

    AnalyticDB for PostgreSQL juga mendukung ekstensi tabel eksternal untuk Object Storage Service (OSS). Anda dapat mengompresi data di penyimpanan eksternal menggunakan gzip dan lebih mengurangi biaya penyimpanan dengan memindahkan data yang tidak memerlukan komputasi real-time ke penyimpanan eksternal.

    Tabel berikut mencantumkan spesifikasi untuk instans High-Performance.


    Spesifikasi high-performance
    CPU
    Memori
    Ruang penyimpanan

    gpdb.group.segsdx1
    1 Core
    8 GB
    80 GB SSD

    gpdb.group.segsdx2
    2 Cores
    16 GB
    160 GB SSD

    gpdb.group.segsdx16
    16 Cores
    128 GB
    1,28 TB SSD

    Tabel berikut mencantumkan spesifikasi untuk instans High-Capacity.


    Spesifikasi high-capacity
    CPU
    Memori
    Ruang penyimpanan

    gpdb.group.seghdx4
    4 Cores
    32 GB
    2 TB HDD

    gpdb.group.seghdx36
    36 Cores
    288 GB
    18 TB HDD

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

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

    string

    ID instans.

    gp-bp12ga6v69h86****
    Port

    string

    Parameter ini sudah tidak digunakan lagi dan tidak dikembalikan.

    Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk menanyakan nomor port instans.

    3432
    ConnectionString

    string

    Parameter ini sudah tidak digunakan lagi dan tidak dikembalikan.

    Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk menanyakan titik akhir instans.

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

    string

    ID pesanan.

    111111111111

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.