全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::GPDB::DBInstance

更新时间:Aug 07, 2025

ALIYUN::GPDB::DBInstance digunakan untuk membuat instance AnalyticDB for PostgreSQL dalam mode penyimpanan cadangan.

Sintaksis

{
  "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,
    "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

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

EngineVersion

String

Ya

Tidak

Versi mesin.

Nilai yang valid:

  • 6.0: Edisi Standar 6.0

  • 6.0x: Edisi Vektor Ditingkatkan 6.0

AINodeSpecInfos

List

Tidak

Tidak

Informasi tentang node AI.

Untuk informasi lebih lanjut, lihat Properti AINodeSpecInfos.

VSwitchId

String

Ya

Tidak

ID vSwitch.

Contoh: vsw-bp183p93qs667muql****.

DBInstanceClass

String

Tidak

Tidak

Keluarga tipe instance.

Contoh: gpdb.group.segsdx2.

DBInstanceGroupCount

Integer

Tidak

Tidak

Jumlah node komputasi dalam instance AnalyticDB for PostgreSQL.

Contoh: 2.

VPCId

String

Tidak

Tidak

ID dari virtual private cloud (VPC).

Contoh: vpc-bp1m6fww66xbntjyc****.

SecurityIPList

String

Tidak

Ya

Daftar putih alamat IP.

Nilai default: 127.0.0.1.

DBInstanceDescription

String

Tidak

Ya

Deskripsi instance.

Contoh: Instance DB AnalyticDB PostgreSQL.

Deskripsi dapat memiliki panjang hingga 256 karakter.

PayType

String

Tidak

Ya

Metode penagihan.

Nilai yang valid:

  • Postpaid (default): bayar sesuai pemakaian

  • Prepaid: langganan

Period

Integer

Tidak

Ya

Durasi langganan instance.

  • Nilai yang valid ketika PeriodUnit diatur ke Bulan: 1 hingga 11.

  • Nilai yang valid ketika PeriodUnit diatur ke Tahun: 1 hingga 3.

PeriodUnit

String

Tidak

Ya

Unit durasi langganan.

Nilai yang valid:

  • Bulan (default)

  • Tahun

Tags

List

Tidak

Tidak

Tag kustom instance.

Untuk informasi lebih lanjut, lihat Properti Tags.

EncryptionType

String

Tidak

Tidak

Tipe enkripsi.

Nilai yang valid:

  • NULL (default): menonaktifkan enkripsi.

  • CloudDisk: mengaktifkan enkripsi pada disk cloud. Dalam hal ini, Anda harus menggunakan EncryptionKey untuk menentukan kunci enkripsi.

Catatan

Enkripsi disk tidak dapat dinonaktifkan setelah diaktifkan.

MasterNodeNum

Integer

Tidak

Tidak

Jumlah node koordinator.

Nilai yang valid: 1 hingga 2.

Catatan

Jika Anda tidak mengisi properti ini, nilai 1 akan digunakan.

DBInstanceMode

String

Tidak

Tidak

Mode sumber daya instance.

Nilai yang valid:

  • StorageElastic: mode penyimpanan elastis

  • Serverless: mode Serverless

  • Classic: mode penyimpanan cadangan

SegDiskPerformanceLevel

String

Tidak

Tidak

Tingkat performa (PL) dari SSD ditingkatkan (ESSD).

Nilai yang valid:

  • pl0

  • pl1

  • pl2

Catatan

Properti ini hanya berlaku ketika SegStorageType diatur ke cloud_essd.

Jika Anda tidak menentukan properti ini, pl1 akan digunakan.

DBInstanceCategory

String

Tidak

Tidak

Edisi instance.

Nilai yang valid:

  • HighAvailability: Edisi Ketersediaan Tinggi

  • Basic: Edisi Dasar

Catatan

Anda harus menentukan properti ini saat membuat instance dalam mode penyimpanan elastis.

SegStorageType

String

Tidak

Tidak

Tipe penyimpanan disk.

Atur nilai menjadi cloud_essd. Nilai cloud_essd menentukan sebuah ESSD.

Catatan

Anda harus menentukan properti ini saat membuat instance dalam mode penyimpanan elastis.

StorageSize

Integer

Tidak

Tidak

Ukuran ruang penyimpanan.

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

EncryptionKey

String

Tidak

Tidak

ID kunci.

Jika EncryptionType diatur ke CloudDisk, Anda harus menggunakan EncryptionKey untuk menentukan ID kunci enkripsi yang berada di wilayah yang sama dengan disk cloud yang ditentukan oleh EncryptionType. Jika EncryptionType tidak diatur ke CloudDisk, Anda harus meninggalkan EncryptionKey kosong.

CreateSampleData

Boolean

Tidak

Tidak

Menentukan apakah akan memuat dataset sampel setelah instance dibuat.

Nilai yang valid:

  • true

  • false (default)

ServerlessMode

String

Tidak

Tidak

Mode Serverless instance.

Nilai yang valid:

  • Manual (default): penjadwalan manual

  • Auto: penjadwalan otomatis

Catatan

Anda harus menentukan properti ini hanya saat membuat instance dalam mode Serverless.

ServerlessResource

Integer

Tidak

Tidak

Ambang batas sumber daya komputasi.

Unit: Unit Komputasi AnalyticDB (ACU). Nilai yang valid: 8 hingga 32. Nilai harus dalam kelipatan 8 ACU. Nilai default: 32.

Catatan

Anda harus menentukan properti ini hanya saat membuat instance dalam mode Serverless otomatis.

PrivateIpAddress

String

Tidak

Tidak

Alamat IP pribadi instance.

Tidak ada.

SegNodeNum

Integer

Tidak

Tidak

Jumlah node komputasi.

  • Nilai yang valid untuk instance Edisi Ketersediaan Tinggi dalam mode penyimpanan elastis: kelipatan 4 dalam rentang 4 hingga 512.

  • Nilai yang valid untuk instance Edisi Dasar dalam mode penyimpanan elastis: kelipatan 2 dalam rentang 2 hingga 512.

  • Nilai yang valid untuk instance dalam mode Serverless: kelipatan 2 dalam rentang 2 hingga 512.

Catatan

Anda harus menentukan properti ini saat membuat instance dalam mode penyimpanan elastis atau mode Serverless.

InstanceSpec

String

Tidak

Tidak

Spesifikasi node komputasi.

  • Nilai yang valid untuk instance Edisi Ketersediaan Tinggi dalam mode penyimpanan elastis:

    • 2C16G

    • 4C32G

    • 16C128G

  • Nilai yang valid untuk instance Edisi Dasar dalam mode penyimpanan elastis:

    • 2C8G

    • 4C16G

    • 8C32G

    • 16C64G

  • Nilai yang valid untuk instance dalam mode Serverless:

    • 4C16G

    • 8C32G

Catatan

Anda harus menentukan properti ini saat membuat instance dalam mode penyimpanan elastis atau mode Serverless.

IdleTime

Integer

Tidak

Tidak

Waktu tunggu untuk instance yang tidak memiliki lalu lintas menjadi idle.

Instance menjadi idle setelah periode waktu tanpa lalu lintas bisnis mencapai ambang batas yang ditentukan. Nilai minimum: 60. Nilai default: 600. Unit: detik.

Catatan

Anda harus menentukan properti ini hanya saat membuat instance dalam mode Serverless otomatis.

ProdType

String

Tidak

Tidak

Tipe produk.

Nilai yang valid:

  • standard (default): Edisi Standar

  • cost-effective: Edisi Hemat Biaya

MasterCU

Integer

Tidak

Tidak

Jumlah sumber daya node koordinator.

Tidak ada.

StandbyZoneId

String

Tidak

Tidak

ID zona sekunder.

Tidak ada.

StandbyVSwitchId

String

Tidak

Tidak

ID vSwitch sekunder.

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 akan mengaktifkan optimasi mesin pencarian vektor.

Nilai yang valid:

  • enabled

  • disabled (default)

Catatan
  • Kami menyarankan Anda untuk tidak mengaktifkan optimasi mesin pencarian vektor dalam skenario analisis arus utama, gudang data, dan gudang data waktu nyata.

  • Kami menyarankan Anda untuk mengaktifkan optimasi mesin pencarian vektor dalam skenario Konten yang Dihasilkan AI (AIGC) dan pengambilan vektor yang memerlukan mesin analisis vektor.

ZoneId

String

Ya

Tidak

ID zona.

Contoh: cn-hangzhou-h.

Untuk informasi lebih lanjut tentang ID zona, lihat DescribeRegions.

Sintaksis AINodeSpecInfos

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

Properti AINodeSpecInfos

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

AINodeSpec

String

Ya

Tidak

Spesifikasi node AI.

Tidak ada.

AINodeNum

Integer

Ya

Tidak

Jumlah node AI.

Tidak ada.

Sintaksis Tags

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

Properti Tags

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Key

String

Ya

Tidak

Kunci tag.

Kunci tag harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Kunci tag tidak boleh dimulai dengan aliyun atau acs:.

Value

String

Tidak

Tidak

Nilai tag.

Nilai tag dapat memiliki panjang hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Nilai tag tidak boleh dimulai dengan aliyun atau acs:.

Nilai Pengembalian

Fn::GetAtt

  • DBInstanceId: ID instance.

  • Port: port.

  • OrderId: ID pesanan.

  • ConnectionString: titik akhir.

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

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"] }
    }
  }
}