All Products
Search

This Product

    AnalyticDB:CreateDBInstance

    Document Center

    AnalyticDB:CreateDBInstance

    Last Updated:Jun 12, 2026

    Membuat instance AnalyticDB for PostgreSQL.

    Deskripsi operasi

    Sebelum menggunakan operasi ini, pastikan Anda memahami metode penagihan dan harga dari 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 region.

    Catatan

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID region yang tersedia.

    cn-hangzhou
    ZoneId

    string

    Yes

    ID zona.

    Catatan

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona yang tersedia.

    cn-hangzhou-i
    EngineVersion

    string

    Yes

    Versi engine. Nilai yang valid:

    • 6.0: Versi 6.0.

    • 7.0: Versi 7.0.

    6.0
    Engine

    string

    Yes

    Engine database. Tetapkan nilainya ke gpdb.

    gpdb
    DBInstanceClass

    string

    No

    Spesifikasi instance. Untuk informasi lebih lanjut, lihat deskripsi tambahan parameter DBInstanceClass.

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance dalam mode penyimpanan terpesan.

    gpdb.group.segsdx1
    DBInstanceGroupCount

    string

    No

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

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance dalam mode penyimpanan terpesan.

    2
    DBInstanceDescription

    string

    No

    Deskripsi instance.

    test
    SecurityIPList

    string

    No

    Daftar putih alamat IP.

    Nilai 127.0.0.1 menolak akses dari alamat IP eksternal mana pun. Anda dapat memanggil operasi ModifySecurityIps untuk memodifikasi daftar putih alamat IP setelah instance dibuat.

    127.0.0.1
    PayType

    string

    No

    Metode penagihan. Nilai yang valid:

    • Postpaid: bayar sesuai pemakaian.

    • Prepaid: berlangganan.

    Catatan

    • Jika Anda tidak menentukan parameter ini, nilai defaultnya adalah bayar sesuai pemakaian.

    • Untuk metode penagihan berlangganan, Anda dapat memperoleh diskon ketika membeli instance selama satu tahun atau lebih dalam satu kali pembelian. Kami menyarankan Anda untuk memilih metode penagihan berdasarkan kebutuhan bisnis Anda.

    Prepaid
    Period

    string

    No

    Satuan durasi berlangganan. Nilai yang valid:

    • Month

    • Year

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance berlangganan.

    Month
    UsedTime

    string

    No

    Durasi berlangganan. Nilai yang valid:

    • Jika Period ditetapkan ke Month, nilainya berkisar dari 1 hingga 9.

    • Jika Period ditetapkan ke Year, nilainya berkisar dari 1 hingga 3.

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance berlangganan.

    1
    ClientToken

    string

    No

    Pemeriksaan idempotensi. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

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

    string

    No

    Tipe jaringan instance. Tetapkan nilainya ke VPC.

    Catatan

    • Hanya tipe jaringan VPC yang didukung di cloud publik.

    • Jika Anda tidak menentukan parameter ini, nilai defaultnya adalah VPC.

    VPC
    VPCId

    string

    No

    ID VPC.

    Catatan

    • VPCId diperlukan.

    • Region tempat VPC berada harus sama dengan region yang ditentukan oleh RegionId.

    vpc-bp19ame5m1r3oejns****
    VSwitchId

    string

    No

    ID vSwitch.

    Catatan

    • vSwitchId diperlukan.

    • Zona tempat vSwitch berada harus sama dengan zona yang ditentukan oleh ZoneId.

    vsw-bp1cpq8mr64paltkb****
    PrivateIpAddress

    string

    No

    Parameter ini sudah tidak digunakan dan tidak perlu ditentukan.

    null
    SegStorageType

    string

    No

    Tipe penyimpanan disk. Saat ini hanya ESSD yang didukung. Tetapkan nilainya ke cloud_essd.

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance dalam mode penyimpanan elastis.

    cloud_essd
    SegDiskPerformanceLevel

    string

    No

    Level performa ESSD. Nilai yang valid:

    • pl0: PL0.

    • pl1: PL1.

    • pl2: PL2.

    Catatan

    • Parameter ini hanya berlaku ketika tipe penyimpanan disk adalah ESSD.

    • Jika Anda tidak menentukan parameter ini, nilai defaultnya adalah PL1.

    pl1
    InstanceSpec

    string

    No

    Spesifikasi node komputasi.

    Nilai yang valid untuk High-availability Edition dalam mode penyimpanan elastis:

    • 2C16G

    • 4C32G

    • 16C128G

    Nilai yang valid untuk Basic Edition dalam mode penyimpanan elastis:

    • 2C8G

    • 4C16G

    • 8C32G

    • 16C64G

    Nilai yang valid untuk mode Serverless:

    • 4C16G

    • 8C32G

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance dalam mode penyimpanan elastis atau mode Serverless.

    2C16G
    SegNodeNum

    string

    No

    Jumlah node komputasi. Nilai yang valid:

    • Untuk High-availability Edition dalam mode penyimpanan elastis, nilainya berkisar dari 4 hingga 512 dan harus merupakan kelipatan 4.

    • Untuk Basic Edition dalam mode penyimpanan elastis, nilainya berkisar dari 2 hingga 512 dan harus merupakan kelipatan 2.

    • Untuk mode Serverless, nilainya berkisar dari 2 hingga 512 dan harus merupakan kelipatan 2.

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance dalam mode penyimpanan elastis atau mode Serverless.

    4
    MasterNodeNum

    string

    No

    Parameter ini sudah tidak digunakan dan tidak perlu ditentukan.

    null
    DBInstanceMode

    string

    Yes

    Tipe sumber daya instance. Nilai yang valid:

    • StorageElastic: mode penyimpanan elastis.

    • Serverless: mode Serverless.

    • Classic: mode penyimpanan terpesan.

    Catatan

    Parameter ini diperlukan.

    StorageElastic
    StorageType

    string

    No

    Parameter ini sudah tidak digunakan dan tidak perlu ditentukan.

    null
    DBInstanceCategory

    string

    No

    Edisi instance. Nilai yang valid:

    • HighAvailability: High-availability Edition.

    • Basic: Basic Edition.

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance dalam mode penyimpanan elastis.

    HighAvailability
    ResourceGroupId

    string

    No

    ID grup sumber daya perusahaan tempat instance berada.

    rg-bp67acfmxazb4p****
    StorageSize

    integer

    No

    Ukuran penyimpanan, dalam GB. Nilai yang valid: 50 hingga 6000.

    Catatan

    Parameter ini harus ditentukan ketika Anda membuat instance dalam mode penyimpanan elastis.

    200
    CreateSampleData

    boolean

    No

    Menentukan apakah akan memuat sampel dataset setelah instance dibuat. Nilai yang valid:

    • true: Muat sampel dataset.

    • false: Jangan muat sampel dataset.

    Catatan

    Jika Anda tidak menentukan parameter ini, tidak ada sampel dataset yang dimuat secara default.

    false
    Tag

    array<object>

    No

    Tag ke-N. Nilai N berkisar dari 1 hingga 20.

    object

    No

    Tag ke-N. Nilai N berkisar dari 1 hingga 20.

    Key

    string

    No

    Kunci tag. Batasan berikut berlaku:

    • Kunci tag tidak boleh berupa string kosong.

    • Kunci tag dapat memiliki panjang hingga 128 karakter.

    • Kunci tag tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh berisi http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai tag. Batasan berikut berlaku:

    • Nilai tag dapat berupa string kosong.

    • Nilai tag dapat memiliki panjang hingga 128 karakter.

    • Nilai tag tidak boleh diawali dengan acs:, dan tidak boleh berisi http:// atau https://.

    TestValue
    ServerlessResource

    integer

    No

    Ambang batas sumber daya komputasi. Nilai yang valid: 8 hingga 32, dengan kelipatan 8. Satuan: ACU. Nilai default: 32.

    Catatan

    Parameter ini hanya perlu ditentukan untuk instance dalam mode penjadwalan otomatis Serverless.

    32
    IdleTime

    integer

    No

    Waktu tunggu pelepasan idle. Instance memasuki status idle ketika durasi tanpa lalu lintas layanan mencapai waktu yang ditentukan. Satuan: detik. Nilai minimum: 60. Nilai default: 600.

    Catatan

    Parameter ini hanya perlu ditentukan untuk instance dalam mode penjadwalan otomatis Serverless.

    600
    ServerlessMode

    string

    No

    Mode instance Serverless. Nilai yang valid:

    • Manual: penjadwalan manual. Ini adalah nilai default.

    • Auto: penjadwalan otomatis.

    Catatan

    • Parameter ini hanya perlu ditentukan untuk instance Serverless.

    • Mode penjadwalan otomatis Serverless dari AnalyticDB for PostgreSQL berada dalam pratinjau undangan. Untuk menggunakan fitur ini, kirim tiket untuk mengajukan kualifikasi pratinjau undangan.

    Auto
    EncryptionType

    string

    No

    Tipe enkripsi. Nilai yang valid:

    • NULL: Enkripsi tidak diaktifkan. Ini adalah nilai default.

    • CloudDisk: Enkripsi disk diaktifkan. Kunci enkripsi ditentukan oleh parameter EncryptionKey.

    Catatan

    Enkripsi disk tidak dapat dinonaktifkan setelah diaktifkan.

    CloudDisk
    EncryptionKey

    string

    No

    ID kunci enkripsi.

    Catatan

    Jika nilai parameter EncryptionType adalah CloudDisk, Anda harus menentukan ID kunci enkripsi di region yang sama dengan instance menggunakan parameter ini. Jika tidak, biarkan parameter ini kosong.

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

    string

    No

    Menentukan apakah akan mengaktifkan optimasi vector engine. Nilai yang valid:

    • enabled: Aktifkan optimasi vector engine.

    • disabled (default): Jangan aktifkan optimasi vector engine.

    Catatan

    • Untuk skenario analitik utama, skenario gudang data, dan skenario gudang data real-time, kami menyarankan agar Anda tidak mengaktifkan optimasi vector engine.

    • Untuk pengguna yang menggunakan vector analytics engine untuk skenario seperti AIGC dan pengambilan vektor, kami menyarankan agar Anda mengaktifkan optimasi vector engine.

    enabled
    MasterCU

    integer

    No

    Sumber daya master. Nilai yang valid:

    • 2 CU

    • 4 CU

    • 8 CU

    • 16 CU

    • 32 CU

    Catatan

    Sumber daya master yang lebih dari 8 CU dikenakan biaya.

    8 CU
    SrcDbInstanceName

    string

    No

    ID instance sumber yang akan dikloning.

    Catatan

    Anda dapat memanggil operasi DescribeDBInstances untuk mengkueri detail semua instance AnalyticDB for PostgreSQL di region tertentu, termasuk ID instance.

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

    string

    No

    ID set cadangan.

    Catatan

    Anda dapat memanggil operasi DescribeDataBackups untuk mengkueri ID semua set cadangan dari instance tertentu.

    1111111111
    EnableSSL

    boolean

    No

    Menentukan apakah akan mengaktifkan enkripsi SSL. Nilai yang valid:

    • true: Aktifkan enkripsi SSL.

    • false (default): Jangan aktifkan enkripsi SSL.

    false
    ProdType

    string

    No

    Tipe produk. Nilai yang valid:

    • standard: Standard Edition.

    • cost-effective: Cost-effective Edition.

    Catatan

    Jika Anda tidak menentukan parameter ini, nilai defaultnya adalah Standard Edition.

    standard
    DeployMode

    string

    No

    Mode deployment. Nilai yang valid:

    • multiple: deployment multi-zona.

    • single: deployment zona tunggal.

    Catatan

    • Jika Anda tidak menentukan parameter ini, nilai defaultnya adalah deployment zona tunggal.

    • Saat ini, hanya deployment zona tunggal yang didukung.

    single
    StandbyZoneId

    string

    No

    ID zona standby.

    Catatan

    • Parameter ini hanya perlu ditentukan untuk deployment multi-zona.

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

    • ID zona standby harus berbeda dari ID zona primer.

    cn-hangzhou-j
    StandbyVSwitchId

    string

    No

    ID vSwitch dari zona standby.

    Catatan

    • Parameter ini hanya perlu ditentukan untuk deployment multi-zona.

    • Zona tempat vSwitch standby berada harus sama dengan zona yang ditentukan oleh StandbyZoneId.

    vsw-bp1cpq8mr64paltkb****
    MasterAISpec

    string

    No

    Tentukan parameter ini jika Anda perlu mengubah node Master menjadi node MasterAI.

    Catatan

    • Parameter ini tidak dapat ditentukan bersama dengan MasterCU.

    • Hanya beberapa region dan zona yang mendukung perubahan node Master menjadi node MasterAI.

    • Hanya instance Basic Edition dari AnalyticDB for PostgreSQL V7.0 yang mendukung node MasterAI.

    • Anda dapat mengkueri semua nilai yang mungkin untuk parameter ini pada halaman pembelian konfigurasi ulang node Master.

    ADB.AIMedium.2
    AINodeSpecInfos

    array<object>

    No

    Informasi spesifikasi node AI.

    object

    No

    Informasi spesifikasi node AI.

    AINodeNum

    string

    No

    Jumlah node AI.

    1
    AINodeSpec

    string

    No

    Spesifikasi node AI.

    ADB.AIMedium.2
    CacheStorageSize

    string

    No

    Ukuran penyimpanan cache Serverless, dalam GB.

    800

    Deskripsi tambahan parameter DBInstanceClass

    AnalyticDB for PostgreSQL saat ini mendukung dua spesifikasi instance berikut:

    • High-performance: Nama spesifikasi diawali dengan gpdb.group.segsdx. Tipe ini memberikan kemampuan I/O yang lebih baik dan performa yang lebih tinggi.

    • High-capacity: Nama spesifikasi diawali dengan gpdb.group.seghdx. Tipe ini memberikan penyimpanan yang lebih besar dan lebih hemat biaya untuk memenuhi kebutuhan penyimpanan yang lebih tinggi.

    Oleh karena itu, ketika Anda memilih spesifikasi instance, kami menyarankan agar Anda membuat pilihan berdasarkan ukuran penyimpanan dan kemampuan komputasi yang diperlukan.

    Selain itu, AnalyticDB for PostgreSQL mendukung ekstensi tabel eksternal berbasis OSS dan dapat mengompresi data pada penyimpanan eksternal menggunakan gzip. Data yang tidak perlu berpartisipasi dalam komputasi real-time dapat disimpan pada penyimpanan eksternal untuk lebih menghemat biaya penyimpanan.

    Spesifikasi instance high-performance tercantum pada tabel berikut:


    [High-performance] Spesifikasi
    CPU
    Memori
    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

    Spesifikasi instance high-capacity tercantum pada tabel berikut:


    [High-capacity] Spesifikasi
    CPU
    Memori
    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 instance.

    gp-bp12ga6v69h86****
    Port

    string

    Parameter ini sudah tidak digunakan dan tidak ada nilai yang dikembalikan.

    Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk mengkueri nomor port instance.

    3432
    ConnectionString

    string

    Parameter ini sudah tidak digunakan dan tidak ada nilai yang dikembalikan.

    Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk mengkueri endpoint koneksi instance.

    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.