All Products
Search
Document Center

PolarDB:CreateDBCluster

Last Updated:Jul 24, 2026

Membuat kluster PolarDB Basis Data Relasional Cloud-Native.

Deskripsi operasi

TautanDB dapat menghubungkan dua kluster PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Kompatibel dengan Oracle), atau menghubungkan kluster PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Kompatibel dengan Oracle) ke database PostgreSQL yang dikelola sendiri pada Instans ECS. Anda dapat menggunakan TautanDB untuk mengkueri data lintas kluster.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah.

cn-hangzhou.

ZoneId

string

No

ID zona.

cn-hangzhou-j.

Architecture

string

No

Arsitektur CPU. Nilai valid:

X86

DBType

string

Yes

Tipe mesin database. Nilai valid:

MySQL.

DBVersion

string

Yes

Versi mesin database.

5.6

DBNodeClass

string

No

Spesifikasi node. Untuk detailnya, lihat topik berikut:

polar.mysql.x4.medium.

ClusterNetworkType

string

No

Jenis jaringan kluster. Saat ini, hanya Virtual Private Cloud (VPC) yang didukung. Atur nilai menjadi VPC.

VPC.

DBClusterDescription

string

No

Nama kluster. Nama kluster harus memenuhi persyaratan berikut:

test.

PayType

string

Yes

Metode penagihan. Nilai valid:

Postpaid.

AutoRenew

boolean

No

Apakah akan mengaktifkan perpanjangan otomatis. Nilai valid:

true.

Period

string

No

Parameter ini diperlukan ketika PayType diatur ke Prepaid. Menentukan apakah Kluster langganan menggunakan siklus penagihan tahunan atau bulanan.

Month.

UsedTime

string

No

Parameter ini diperlukan ketika PayType diatur ke Prepaid.

1

VPCId

string

No

ID VPC.

vpc-**********

VSwitchId

string

No

ID vSwitch.

vsw-**********

CreationOption

string

No

Metode yang digunakan untuk membuat kluster. Nilai valid:

Normal.

SourceResourceId

string

No

ID instans dari instans ApsaraDB RDS sumber atau kluster PolarDB Basis Data Relasional Cloud-Native sumber. Parameter ini hanya diperlukan ketika CreationOption diatur ke MigrationFromRDS, CloneFromRDS, CloneFromPolarDB, atau RecoverFromRecyclebin.

rm-*************

CloneDataPoint

string

No

Titik pengatur waktu saat data dikloning. Nilai valid:

LATEST.

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan. Nilai parameter ini dihasilkan oleh klien dan unik di antara berbagai permintaan. Nilai bersifat case-sensitive dan tidak boleh melebihi 64 karakter ASCII.

6000170000591aed949d0f5********************

ResourceGroupId

string

No

ID kelompok sumber daya.

rg-************

SecurityIPList

string

No

Daftar putih IP Kluster PolarDB Basis Data Relasional Cloud-Native.

10.***.***.***

TDEStatus

boolean

No

Apakah akan mengaktifkan Enkripsi Data Transparan (TDE). Nilai valid:

true.

GDNId

string

No

ID global database network (GDN).

gdn-***********

CreationCategory

string

No

Edisi kluster. Nilai valid:

Normal.

DefaultTimeZone

string

No

Zona waktu kluster (UTC). Nilai dapat diatur ke jangka waktu apa pun dalam rentang -12:00 hingga +13:00, seperti 00:00. Nilai default: SYSTEM. Zona waktu default sama dengan zona waktu wilayah.

SYSTEM.

LowerCaseTableNames

string

No

Apakah nama tabel bersifat case-sensitive. Nilai valid:

1

BackupRetentionPolicyOnClusterDeletion

string

No

Kebijakan retensi data untuk cadangan saat kluster dihapus. Nilai valid:

NONE.

StorageSpace

integer

No

Ruang penyimpanan untuk paket penagihan berbasis ruang (langganan). Unit: GB.

50

DBMinorVersion

string

No

Versi minor mesin database. Nilai valid:

8.0.1

ParameterGroupId

string

No

ID template parameter.

pcpg-**************

Tag

array<object>

No

Daftar tag.

object

No

Catatan

Anda dapat memanggil operasi DescribeDBClusters untuk mengkueri tag semua kluster di bawah akun Anda. Jika parameter ini dibiarkan kosong, nilai default adalah false.

Key

string

No

Kunci tag. Untuk menambahkan beberapa tag ke kluster sekaligus, klik Tambah untuk menambahkan kunci tag.

type.

Value

string

No

Nilai tag. Untuk menambahkan beberapa tag ke kluster sekaligus, klik Tambah untuk menambahkan nilai tag.

test.

ServerlessType

string

No

Tipe arsitektur tanpa server. Nilainya tetap sebagai AgileServerless.

AgileServerless.

ScaleMin

string

No

Batas penskalaan minimum per node. Nilai valid: 1 PCU hingga 31 PCU.

1

ScaleMax

string

No

Batas penskalaan maksimum per node. Nilai valid: 1 PCU hingga 32 PCU.

3

AllowShutDown

string

No

Apakah akan mengaktifkan Penangguhan Tanpa Aktivitas. Nilai valid:

true.

ScaleRoNumMin

string

No

Jumlah minimum node baca-saja untuk penskalaan. Nilai valid: 0 hingga 15.

2

ScaleRoNumMax

string

No

Jumlah maksimum node baca-saja untuk penskalaan. Nilai valid: 0 hingga 15.

4

StorageType

string

No

Tipe penyimpanan untuk Edisi Perusahaan. Nilai valid:

PSL4

DBNodeNum

integer

No

Jumlah node untuk Edisi Standar dan Edisi Perusahaan. Nilai valid:

1

HotStandbyCluster

string

No

Apakah kluster hot standby diaktifkan. Nilai valid:

ON

StrictConsistency

string

No

Apakah akan mengaktifkan konsistensi data kuat multi-zona untuk kluster. Nilai valid:

ON

StandbyAZ

string

No

Zona kluster hot standby.

cn-hangzhou-g.

ProxyType

string

No

Tipe proksi database. Nilai valid:

Exclusive.

ProxyClass

string

No

Spesifikasi proksi database untuk Edisi Standar. Nilai valid:

polar.maxscale.g2.medium.c.

LoosePolarLogBin

string

No

Apakah akan mengaktifkan fitur Binlog. Nilai valid:

ON

LooseXEngine

string

No

Apakah akan mengaktifkan mesin penyimpanan X-Engine. Nilai valid:

ON

LooseXEngineUseMemoryPct

string

No

Persentase memori yang dialokasikan ke mesin penyimpanan X-Engine. Nilai valid: bilangan bulat dari 10 hingga 90.

50

StoragePayType

string

No

Tipe penagihan untuk penyimpanan. Nilai valid:

Prepaid.

StorageAutoScale

string

No

Apakah akan mengaktifkan penskalaan penyimpanan otomatis untuk kluster Edisi Standar. Nilai valid:

Enable.

StorageUpperBound

integer

No

Batas atas penskalaan penyimpanan otomatis untuk kluster Edisi Standar. Unit: GB.

800

ProvisionedIops

integer

No

1000

BurstingEnabled

string

No

Apakah akan mengaktifkan lonjakan performa I/O untuk cloud disk ESSD AutoPL. Nilai valid:

false.

TargetMinorVersion

string

No

Versi minor mesin target.

8.0.1.1.54

StorageEncryption

boolean

No

Apakah akan mengaktifkan enkripsi disk. Nilai valid:

StorageEncryptionKey

string

No

ID kunci dari kunci Key Management Service (KMS) kustom untuk enkripsi disk di wilayah yang sama dengan instans. Menentukan parameter ini secara otomatis mengaktifkan enkripsi disk, yang tidak dapat dinonaktifkan setelah diaktifkan. Biarkan parameter ini kosong untuk menggunakan kunci layanan default untuk enkripsi disk.

1022xxxxxxxx.

SourceUid

integer

No

UID akun yang memiliki set cadangan sumber dalam skenario pemulihan cadangan lintas akun.

1022xxxxxxxx.

CloudProvider

string

No

Penyedia layanan cloud tempat instans berada.

ENS.

EnsRegionId

string

No

ID node ENS yang diperlukan saat membuat database ENS.

vn-hanoi-3

AutoUseCoupon

boolean

No

Apakah akan menggunakan kupon secara otomatis. Nilai valid:

true.

PromotionCode

string

No

Kode kupon. Jika tidak ditentukan, kupon default akan digunakan.

727xxxxxx934

AgenticDbType

string

No

Tipe mesin database Agentic. Nilai valid:

dedicated.

AgenticDbClusterId

string

No

ID kluster Agentic.

pagc-******

AgenticDbClusterDescription

string

No

Deskripsi kluster Agentic.

pagc-******

Elemen respons

Element

Type

Description

Example

object

DBClusterId

string

ID kluster.

pc-bp1s826a1up******

OrderId

string

ID pesanan.

211454967******

RequestId

string

ID permintaan.

E56531A4-E552-40BA-9C58-137B80******

ResourceGroupId

string

ID kelompok sumber daya.

rg-***************

AgenticDbClusterId

string

ID kluster Agentic.

pagc-***************

AgenticDbClusterDescription

string

Deskripsi kluster Agentic.

pagc-***************

Contoh

Respons sukses

JSONformat

{
  "DBClusterId": "pc-bp1s826a1up******",
  "OrderId": "211454967******",
  "RequestId": "E56531A4-E552-40BA-9C58-137B80******",
  "ResourceGroupId": "rg-***************",
  "AgenticDbClusterId": "pagc-***************",
  "AgenticDbClusterDescription": "pagc-***************"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidBackupRetentionPolicyOnClusterDeletion.Malformed The specified BackupRetentionPolicyOnClusterDeletion is invalid. Parameter BackupRetentionPolicyOnClusterDeletion yang ditentukan untuk kebijakan retensi cadangan saat penghapusan kluster tidak valid.
400 InvalidLowerCaseTableNames.Malformed The specified LowerCaseTableNames is invalid. Parameter sensitivitas huruf besar/kecil (LowerCaseTableNames) yang ditentukan tidak valid.
400 InvalidDefaultTimeZone.Malformed The specified DefaultTimeZone is invalid. Parameter zona waktu default (DefaultTimeZone) yang ditentukan tidak valid.
400 Location.FailedGetSubDomain The specified regionId does not match the zoneId or the zoneId does not exist. ID wilayah yang ditentukan tidak cocok dengan ID zona, atau ID zona tidak ada.
400 MissParameter.GDNId The GDNId parameter is required. Parameter GDNId diperlukan.
400 EntityNotExist.ResourceGroup The resource group does not exist.. Kelompok sumber daya tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.