All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::GPDB::DBInstance

Last Updated:Mar 28, 2026

Gunakan resource ALIYUN::GPDB::DBInstance untuk membuat instans AnalyticDB for PostgreSQL dalam mode penyimpanan reserved.

Sintaks

{
  "Type": "ALIYUN::GPDB::DBInstance",
  "Properties": {
    "EngineVersion": String,
    "ZoneId": String,
    "VSwitchId": String,   
    "DBInstanceClass": String,
    "DBInstanceGroupCount": Integer,
    "VPCId": String,
    "SecurityIPList": String,   
    "DBInstanceDescription": String,
    "PayType": String,
    "Period": Integer,
    "PeriodUnit": String,
    "Tags": List,
    "VectorConfigurationStatus": String,
    "StorageSize": Integer,
    "EncryptionType": String,
    "MasterNodeNum": Integer,
    "DBInstanceMode": String,
    "SegDiskPerformanceLevel": String,
    "DBInstanceCategory": String,
    "SegStorageType": String,
    "CacheStorageSize": String,
    "BackupId": String,
    "MasterAISpec": String,
    "EnableSSL": Boolean,
    "SrcDbInstanceName": String,
    "EncryptionKey": String,
    "CreateSampleData": Boolean,
    "ServerlessMode": String,
    "ServerlessResource": Integer,
    "PrivateIpAddress": String,
    "SegNodeNum": Integer,
    "InstanceSpec": String,
    "IdleTime": Integer,
    "ProdType": String,
    "MasterCU": Integer,
    "StandbyZoneId": String,
    "StandbyVSwitchId": String,
    "DeployMode": String,
    "AINodeSpecInfos": List,
    "ResourceGroupId": String
  }
}

Properti

Parameter

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

EngineVersion

String

Ya

Tidak

Versi engine.

Nilai yang valid:

  • 6.0: Edisi Standar.

  • 6.0x: Edisi Vector-enhanced.

AINodeSpecInfos

List

Tidak

Tidak

Detail node AI.

Untuk informasi lebih lanjut, lihat bagian properti AINodeSpecInfos.

VSwitchId

String

Ya

Tidak

ID VSwitch.

Contoh: vsw-bp183p93qs667muql****.

BackupId

String

Tidak

Tidak

ID set cadangan historis.

Tidak ada.

CacheStorageSize

String

Tidak

Tidak

Ukuran disk cache.

Unit: GB.

EnableSSL

Boolean

Tidak

Tidak

Menentukan apakah enkripsi SSL diaktifkan.

Nilai yang valid:

  • true: Mengaktifkan enkripsi SSL.

  • false (default): Menonaktifkan enkripsi SSL.

MasterAISpec

String

Tidak

Tidak

Spesifikasi untuk meningkatkan node koordinator menjadi node MasterAI.

Catatan

Anda tidak dapat menentukan parameter ini dan parameter MasterCU secara bersamaan.

Peningkatan ini hanya didukung di wilayah dan zona ketersediaan tertentu.

Hanya instans Edisi Dasar AnalyticDB for PostgreSQL 7.0 yang mendukung node MasterAI.

Anda dapat menemukan nilai yang valid untuk parameter ini di halaman peningkatan instans.

SrcDbInstanceName

String

Tidak

Tidak

ID instans sumber yang akan dikloning.

Tidak ada.

DBInstanceClass

String

Tidak

Tidak

Tipe instans.

Contoh: gpdb.group.segsdx2.

DBInstanceGroupCount

Integer

Tidak

Tidak

Jumlah kelompok komputasi.

Contoh: 2.

VPCId

String

Tidak

Tidak

ID Virtual Private Cloud (VPC).

Contoh: vpc-bp1m6fww66xbntjyc****.

SecurityIPList

String

Tidak

Ya

Daftar putih alamat IP untuk instans.

Nilai default: 127.0.0.1.

DBInstanceDescription

String

Tidak

Ya

Deskripsi instans.

Contoh: AnalyticDB for PostgreSQL DB Instance.

Panjang deskripsi maksimal 256 karakter.

PayType

String

Tidak

Ya

Metode penagihan instans.

Nilai yang valid:

  • Postpaid (default): metode penagihan bayar sesuai pemakaian.

  • Prepaid: metode penagihan langganan.

Period

Integer

Tidak

Ya

Durasi langganan.

Parameter ini wajib hanya jika Anda menyetel PayType ke Prepaid. Nilai yang valid:

  • Jika Anda menyetel PeriodUnit ke Month, nilai yang valid adalah 1 hingga 11.

  • Jika Anda menyetel PeriodUnit ke Year, nilai yang valid adalah 1, 2, dan 3.

PeriodUnit

String

Tidak

Ya

Unit durasi langganan.

Parameter ini wajib hanya jika Anda menyetel PayType ke Prepaid. Nilai yang valid:

  • Month (default)

  • Year

Tags

List

Tidak

Tidak

Tag instans.

Untuk informasi lebih lanjut, lihat bagian properti Tags.

EncryptionType

String

Tidak

Tidak

Tipe enkripsi.

Nilai yang valid:

  • NULL (default): Menonaktifkan enkripsi cloud disk.

  • CloudDisk: Mengaktifkan enkripsi cloud disk. Jika Anda memilih nilai ini, Anda harus menentukan parameter EncryptionKey.

Catatan

Enkripsi cloud disk tidak dapat dinonaktifkan setelah diaktifkan.

MasterNodeNum

Integer

Tidak

Tidak

Jumlah node koordinator.

Nilai yang valid: 1 dan 2.

Catatan

Jika Anda tidak menentukan parameter ini, nilai default-nya adalah 1.

DBInstanceMode

String

Tidak

Tidak

Mode penyimpanan instans.

Nilai yang valid:

  • StorageElastic: mode penyimpanan elastis.

  • Serverless: mode Serverless.

  • Classic: mode penyimpanan reserved.

SegDiskPerformanceLevel

String

Tidak

Tidak

Tingkat kinerja (PL) enhanced SSD (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 default-nya adalah pl1.

DBInstanceCategory

String

Tidak

Tidak

Edisi instans.

Nilai yang valid:

  • HighAvailability: Edisi Ketersediaan Tinggi.

  • Basic: Edisi Dasar.

Catatan

Parameter ini wajib untuk instans dalam mode penyimpanan elastis.

SegStorageType

String

Tidak

Tidak

Tipe penyimpanan disk.

Saat ini, hanya enhanced SSD (ESSD) yang didukung. Tetapkan nilainya ke cloud_essd.

Catatan

Parameter ini wajib untuk instans dalam mode penyimpanan elastis.

StorageSize

Integer

Tidak

Tidak

Kapasitas penyimpanan.

Unit: GB. Nilai yang valid: 50 hingga 8000.

EncryptionKey

String

Tidak

Tidak

ID kunci.

Parameter ini wajib hanya ketika EncryptionType disetel ke CloudDisk. Anda harus menentukan ID kunci yang berada di wilayah yang sama dengan instans. Jika tidak, biarkan parameter ini kosong.

CreateSampleData

Boolean

Tidak

Tidak

Menentukan apakah dataset sampel dimuat setelah instans dibuat.

Nilai yang valid:

  • true: Memuat dataset sampel.

  • false (default): Tidak memuat dataset sampel.

ServerlessMode

String

Tidak

Tidak

Mode instans Serverless.

Nilai yang valid:

  • Manual (default): penjadwalan manual.

  • Auto: penjadwalan otomatis.

Catatan

Parameter ini wajib untuk instans mode Serverless.

ServerlessResource

Integer

Tidak

Tidak

Ambang batas sumber daya komputasi.

Nilainya harus antara 8 hingga 32, dengan penambahan 8-ACU. Nilai default: 32.

Catatan

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

PrivateIpAddress

String

Tidak

Tidak

Alamat IP pribadi.

Tidak ada.

SegNodeNum

Integer

Tidak

Tidak

Jumlah node komputasi.

Nilai yang valid:

  • Untuk instans Edisi Ketersediaan Tinggi dalam mode penyimpanan elastis: 4 hingga 512. Nilainya harus kelipatan 4.

  • Untuk instans Edisi Dasar dalam mode penyimpanan elastis: 2 hingga 512. Nilainya harus kelipatan 2.

  • Untuk instans mode Serverless: 2 hingga 512. Nilainya harus kelipatan 2.

Catatan

Parameter ini wajib untuk instans dalam mode penyimpanan elastis atau mode Serverless.

InstanceSpec

String

Tidak

Tidak

Spesifikasi node komputasi.

  • Nilai untuk Edisi Ketersediaan Tinggi dalam mode penyimpanan elastis:

    • 2C16G

    • 4C32G

    • 16C128G

  • Nilai untuk Edisi Dasar dalam mode penyimpanan elastis:

    • 2C8G

    • 4C16G

    • 8C32G

    • 16C64G

  • Nilai untuk mode Serverless:

    • 4C16G

    • 8C32G

Catatan

Parameter ini wajib untuk instans dalam mode penyimpanan elastis atau mode Serverless.

IdleTime

Integer

Tidak

Tidak

Durasi idle dalam detik sebelum instans secara otomatis ditangguhkan.

Instans menjadi idle setelah periode tidak aktif ini. Nilai minimum: 60. Nilai default: 600.

Catatan

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

ProdType

String

Tidak

Tidak

Tipe produk.

Nilai yang valid:

  • standard (default): Edisi Standar.

  • cost-effective: Edisi hemat biaya.

MasterCU

Integer

Tidak

Tidak

Sumber daya node koordinator.

Tidak ada.

StandbyZoneId

String

Tidak

Tidak

ID zona ketersediaan secondary.

Tidak ada.

StandbyVSwitchId

String

Tidak

Tidak

ID VSwitch secondary.

Tidak ada.

DeployMode

String

Tidak

Tidak

Mode penyebaran.

Tidak ada.

ResourceGroupId

String

Tidak

Ya

ID kelompok sumber daya.

Tidak ada.

VectorConfigurationStatus

String

Tidak

Tidak

Menentukan apakah optimisasi engine vektor diaktifkan.

Nilai yang valid:

  • enabled: Mengaktifkan optimisasi engine vektor.

  • disabled (default): Menonaktifkan optimisasi engine vektor.

Catatan
  • Kami menyarankan Anda menonaktifkan fitur ini untuk skenario analitik utama, data warehousing, dan data warehousing real-time.

  • Kami menyarankan Anda mengaktifkan fitur ini untuk skenario yang memerlukan engine analisis vektor, seperti konten yang dihasilkan AI (AIGC) dan pengambilan vektor.

ZoneId

String

Ya

Tidak

ID zona ketersediaan.

Contoh: cn-hangzhou-h.

Untuk informasi lebih lanjut mengenai zona ketersediaan, lihat Lihat wilayah dan zona yang tersedia.

Sintaks AINodeSpecInfos

"AINodeSpecInfos": [
  {
    "AINodeSpec": String,
    "AINodeNum": Integer
  }
]

Properti AINodeSpecInfos

Parameter

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

AINodeSpec

String

Ya

Tidak

Spesifikasi node AI.

Tidak ada.

AINodeNum

Integer

Ya

Tidak

Jumlah node AI.

Tidak ada.

Sintaks Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Properti Tags

Parameter

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

Key

String

Ya

Tidak

Kunci tag.

Panjang kunci harus 1 hingga 128 karakter. Kunci tidak boleh diawali dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.

Value

String

Tidak

Tidak

Nilai tag.

Panjang nilai bisa 0 hingga 128 karakter. Nilai tidak boleh diawali dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.

Nilai kembalian

Fn::GetAtt

  • DBInstanceId: ID instans.

  • Port: Nomor port instans.

  • OrderId: ID pesanan.

  • ConnectionString: Titik akhir instans.

  • Arn: Nama Sumber Daya Alibaba Cloud (ARN) instans.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ZoneId:
    Type: String
  VpcId:
    Type: String
    AssociationProperty: 'ALIYUN::ECS::VPC::VPCId'
  VSwitchId:
    Type: String
    AssociationProperty: 'ALIYUN::ECS::VSwitch::VSwitchId'
    AssociationPropertyMetadata:
      ZoneId: ZoneId
      VpcId: VpcId
Resources:
  DBInstance:
    Type: 'ALIYUN::GPDB::DBInstance'
    Properties:
      ZoneId:
        Ref: ZoneId
      VPCId:
        Ref: VpcId
      VSwitchId:
        Ref: VSwitchId
      DBInstanceGroupCount: 2
      EngineVersion: '6.0'
      DBInstanceClass: gpdb.group.segsdx2
      DBInstanceDescription: AnalyticDB PostgreSQL DB Instance
Outputs:
  OrderId:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - OrderId
  ConnectionString:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - ConnectionString
  DBInstanceId:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - DBInstanceId
  Port:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - Port
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ZoneId": {
      "Type": "String"
    },
    "VpcId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId"
    },
    "VSwitchId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "AssociationPropertyMetadata": {
        "ZoneId": "ZoneId",
        "VpcId": "VpcId"
      }
    }
  },
  "Resources": {
    "DBInstance": {
      "Type": "ALIYUN::GPDB::DBInstance",
      "Properties": {
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "VPCId": {
          "Ref": "VpcId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "DBInstanceGroupCount": 2,
        "EngineVersion": "6.0",
        "DBInstanceClass": "gpdb.group.segsdx2",
        "DBInstanceDescription": "AnalyticDB PostgreSQL DB Instance"
      }
    }
  },
  "Outputs": {
    "OrderId": {
      "Value": { "Fn::GetAtt": ["DBInstance", "OrderId"] }
    },
    "ConnectionString": {
      "Value": { "Fn::GetAtt": ["DBInstance", "ConnectionString"] }
    },
    "DBInstanceId": {
      "Value": { "Fn::GetAtt": ["DBInstance", "DBInstanceId"] }
    },
    "Port": {
      "Value": { "Fn::GetAtt": ["DBInstance", "Port"] }
    }
  }
}