全部产品
Search
文档中心

PolarDB:CreateDBCluster

更新时间:Feb 02, 2026

Membuat kluster database.

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

polardb:CreateDBCluster

create

*DBCluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#DbClusterId}

  • polardb:EncryptionRequired
None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah.

Catatan

Panggil operasi DescribeRegions untuk menanyakan wilayah yang tersedia.

cn-hangzhou

ZoneId

string

No

ID zona.

Catatan

Panggil operasi DescribeRegions untuk menanyakan zona yang tersedia.

cn-hangzhou-j

Architecture

string

No

Arsitektur CPU. Nilai yang valid:

  • X86

  • ARM

X86

DBType

string

Yes

Engine database. Nilai yang valid:

  • MySQL

  • PostgreSQL

  • Oracle

MySQL

DBVersion

string

Yes

Versi engine database.

  • Nilai yang valid untuk MySQL:
    • 5.6

    • 5.7

    • 8.0

  • Nilai yang valid untuk PostgreSQL:
    • 11

    • 14

    • 15

Catatan

Untuk membuat kluster serverless untuk PolarDB for PostgreSQL, atur parameter ini ke 14.

Nilai yang valid untuk Oracle: 11 14

5.6

DBNodeClass

string

No

Spesifikasi node. Untuk informasi selengkapnya, lihat dokumen berikut:

Catatan
  • Untuk membuat kluster serverless untuk Edisi Kluster PolarDB untuk MySQL, atur parameter ini ke polar.mysql.sl.small.

  • Untuk membuat kluster serverless untuk Edisi Standar PolarDB untuk MySQL, atur parameter ini ke polar.mysql.sl.small.c.

  • Untuk membuat kluster serverless untuk Edisi Kluster PolarDB untuk PostgreSQL, atur parameter ini ke polar.pg.sl.small.

  • Untuk membuat kluster serverless untuk Edisi Standar PolarDB untuk PostgreSQL, atur parameter ini ke polar.pg.sl.small.c.

  • Untuk membuat kluster serverless untuk kluster PolarDB untuk PostgreSQL (kompatibel dengan Oracle), atur parameter ini ke polar.o.sl.small.

polar.mysql.x4.medium

ClusterNetworkType

string

No

Jenis jaringan kluster. Hanya VPC yang didukung. Atur nilainya ke VPC.

VPC

DBClusterDescription

string

No

Nama kluster. Nama harus memenuhi persyaratan berikut:

  • Tidak boleh diawali dengan http:// atau https://.

  • Panjangnya harus antara 2 hingga 256 karakter.

test

PayType

string

Yes

Metode penagihan. Nilai yang valid:

  • Postpaid: pay-as-you-go.

  • Prepaid: subscription.

Postpaid

AutoRenew

boolean

No

Menentukan apakah akan mengaktifkan perpanjangan otomatis. Nilai yang valid:

  • true: mengaktifkan perpanjangan otomatis.

  • false: menonaktifkan perpanjangan otomatis.

Nilai default: false.

Catatan

Parameter ini hanya berlaku jika Anda mengatur parameter PayType ke Prepaid.

true

Period

string

No

Unit durasi langganan kluster langganan. Parameter ini wajib jika Anda mengatur parameter PayType ke Prepaid. Nilai yang valid:

  • Year: Durasi langganan dalam satuan tahun.

  • Month: Durasi langganan dalam satuan bulan.

Month

UsedTime

string

No

Durasi langganan. Parameter ini wajib jika Anda mengatur parameter PayType ke Prepaid.

  • Jika Anda mengatur Period ke Month, nilai UsedTime adalah bilangan bulat dari 1 hingga 9.

  • Jika Anda mengatur Period ke Year, nilai UsedTime adalah bilangan bulat dari 1 hingga 3.

1

VPCId

string

No

ID VPC.

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

VSwitchId

string

No

ID virtual switch.

Catatan

Jika Anda menentukan VPCId, Anda juga harus menentukan parameter ini.

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

CreationOption

string

No

Metode pembuatan kluster. Nilai yang valid:

Nilai default: Normal.

Catatan

Jika DBType diatur ke MySQL dan DBVersion diatur ke 8.0, parameter ini dapat diatur ke CreateGdnStandby.

Normal

SourceResourceId

string

No

ID instans ApsaraDB RDS sumber atau kluster PolarDB sumber. Parameter ini wajib hanya jika Anda mengatur CreationOption ke MigrationFromRDS, CloneFromRDS, CloneFromPolarDB, atau RecoverFromRecyclebin.

  • Jika Anda mengatur CreationOption ke MigrationFromRDS atau CloneFromRDS, Anda harus mengatur parameter ini ke ID instans ApsaraDB RDS sumber. Instans ApsaraDB RDS sumber harus merupakan instans ApsaraDB RDS untuk MySQL 5.6, 5.7, atau 8.0 Edisi Ketersediaan Tinggi.

  • Jika Anda mengatur CreationOption ke CloneFromPolarDB, Anda harus mengatur parameter ini ke ID kluster PolarDB sumber. Secara default, kluster baru memiliki engine database yang sama dengan kluster sumber. Misalnya, jika kluster sumber adalah kluster MySQL 8.0, Anda harus mengatur DBType ke MySQL dan DBVersion ke 8.0 untuk kluster baru.

  • Jika Anda mengatur CreationOption ke RecoverFromRecyclebin, Anda harus mengatur parameter ini ke ID kluster PolarDB sumber yang telah dirilis. Engine database kluster yang ingin Anda pulihkan dari Keranjang daur ulang harus sama dengan engine database kluster sumber. Misalnya, jika kluster sumber adalah kluster MySQL 8.0, Anda harus mengatur DBType ke MySQL dan DBVersion ke 8.0 untuk kluster yang ingin Anda pulihkan dari Keranjang daur ulang.

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

CloneDataPoint

string

No

Titik waktu untuk kloning. Nilai yang valid:

  • LATEST: titik waktu terbaru.

  • BackupID: ID set cadangan historis. Anda harus menentukan ID set cadangan tersebut.

  • Timestamp: titik waktu tertentu. Anda harus menentukan titik waktu dalam format YYYY-MM-DDThh:mm:ssZ. Waktu harus dalam UTC.

Nilai default: LATEST.

Catatan

Jika Anda mengatur CreationOption ke CloneFromRDS, Anda hanya dapat mengatur parameter ini ke LATEST.

LATEST

ClientToken

string

No

Token klien untuk memastikan permintaan bersifat idempoten. Anda dapat menghasilkan token tersebut, tetapi Anda harus memastikan bahwa token tersebut unik di berbagai permintaan. Token bersifat case-sensitive dan panjangnya tidak boleh melebihi 64 karakter ASCII.

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

ResourceGroupId

string

No

ID kelompok sumber daya.

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

SecurityIPList

string

No

Daftar putih alamat IP kluster.

Catatan

Untuk menambahkan beberapa alamat IP, pisahkan dengan koma (,).

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

TDEStatus

boolean

No

Menentukan apakah akan mengaktifkan Enkripsi Data Transparan (TDE). Nilai yang valid:

  • true: mengaktifkan TDE.

  • false: menonaktifkan TDE. Ini adalah nilai default.

Catatan
  • Parameter ini hanya berlaku jika Anda mengatur DBType ke PostgreSQL atau Oracle.

  • Panggil operasi ModifyDBClusterTDE untuk mengaktifkan TDE pada kluster PolarDB untuk MySQL.

  • Anda tidak dapat menonaktifkan TDE setelah diaktifkan.

true

GDNId

string

No

ID Jaringan Basis Data Global (GDN).

Catatan

Parameter ini wajib jika CreationOption diatur ke CreateGdnStandby.

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

CreationCategory

string

No

Edisi kluster. Nilai yang valid:

  • Normal: Edisi Kluster (default)

  • Basic: Edisi Node Tunggal

  • ArchiveNormal: Edisi X-Engine

  • NormalMultimaster: Edisi Kluster Multi-master

  • SENormal: Edisi Standar

Catatan
  • Basic didukung untuk PolarDB untuk MySQL 5.6, 5.7, dan 8.0, PolarDB untuk PostgreSQL 14, dan PolarDB untuk PostgreSQL (kompatibel dengan Oracle) 2.0.

  • ArchiveNormal dan NormalMultimaster didukung untuk PolarDB untuk MySQL 8.0.

  • SENormal didukung untuk PolarDB untuk MySQL 5.6, 5.7, dan 8.0 serta PolarDB untuk PostgreSQL 14.

Untuk informasi selengkapnya tentang edisi produk, lihat Edisi produk.

Normal

DefaultTimeZone

string

No

Zona waktu kluster. Nilainya harus berupa offset UTC dalam jam, dari **-12:00** hingga **+13:00**. Misalnya, **00:00**. Nilai default adalah **SYSTEM**, yang berarti kluster menggunakan zona waktu yang sama dengan wilayahnya.

Catatan

Parameter ini hanya berlaku jika Anda mengatur DBType ke MySQL.

SYSTEM

LowerCaseTableNames

string

No

Menentukan apakah nama tabel bersifat case-sensitive. Nilai yang valid:

  • 1: Nama tabel tidak case-sensitive.

  • 0: Nama tabel case-sensitive.

Nilai default: 1.

Catatan

Parameter ini hanya berlaku jika Anda mengatur DBType ke MySQL.

1

BackupRetentionPolicyOnClusterDeletion

string

No

Kebijakan retensi backup untuk kluster saat dihapus. Nilai yang valid:

  • ALL: Semua backup disimpan secara permanen.

  • LATEST: Backup terakhir disimpan secara permanen. Backup otomatis dilakukan sebelum kluster dihapus.

  • NONE: Tidak ada set cadangan yang disimpan saat kluster dihapus.

Nilai default adalah NONE, yang berarti tidak ada set cadangan yang disimpan saat kluster dihapus.

Catatan
  • Parameter ini hanya berlaku jika Anda mengatur DBType ke MySQL.

  • Parameter ini tidak didukung untuk kluster serverless.

NONE

StorageSpace

integer

No

Ruang penyimpanan kluster langganan yang menggunakan metode penagihan langganan untuk penyimpanan. Satuan: GB.

Catatan
  • Ruang penyimpanan kluster PolarDB untuk MySQL Edisi Perusahaan berkisar antara 10 GB hingga 50.000 GB.

  • Ruang penyimpanan kluster PolarDB untuk MySQL Edisi Standar berkisar antara 20 GB hingga 64.000 GB.

  • Jika kelas penyimpanan kluster Edisi Standar adalah ESSDAUTOPL, ruang penyimpanan berkisar antara 40 GB hingga 64.000 GB. Ukuran langkahnya adalah 10 GB. Anda hanya dapat menentukan nilai seperti 40, 50, dan 60.

50

DBMinorVersion

string

No

Versi minor engine database. Nilai yang valid:

  • 8.0.2

  • 8.0.1

Catatan

Parameter ini hanya berlaku jika Anda mengatur DBType ke MySQL dan DBVersion ke 8.0.

8.0.1

ParameterGroupId

string

No

ID template parameter.

Catatan

Panggil operasi DescribeParameterGroups untuk menanyakan template parameter di suatu wilayah, termasuk ID setiap template parameter.

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

Tag

array<object>

No

Tag kluster.

object

No

Key

string

No

Kunci tag N. Untuk menambahkan beberapa tag ke kluster, klik Add untuk menambahkan kunci tag.

Catatan

Anda dapat menambahkan hingga 20 tag. Tag.N.Key sesuai dengan Tag.N.Value.

type

Value

string

No

Nilai tag N. Untuk menambahkan beberapa tag ke kluster, klik Add untuk menambahkan nilai tag.

Catatan

Anda dapat menambahkan hingga 20 tag. Tag.N.Value sesuai dengan Tag.N.Key.

test

ServerlessType

string

No

Jenis kluster serverless. Atur nilainya ke AgileServerless.

Catatan

Parameter ini hanya berlaku untuk kluster serverless.

AgileServerless

ScaleMin

string

No

Jumlah minimum Unit Kapasitas PolarDB (PCU) untuk satu node. Nilai yang valid: 1 hingga 31.

Catatan

Parameter ini hanya berlaku untuk kluster serverless.

1

ScaleMax

string

No

Jumlah maksimum PCU untuk satu node. Nilai yang valid: 1 hingga 32.

Catatan

Parameter ini hanya berlaku untuk kluster serverless.

3

AllowShutDown

string

No

Menentukan apakah akan mengaktifkan Penangguhan Tanpa Aktivitas. Nilai yang valid:

  • true: mengaktifkan Penangguhan Tanpa Aktivitas.

  • false: menonaktifkan Penangguhan Tanpa Aktivitas. Ini adalah nilai default.

Catatan

Parameter ini hanya berlaku untuk kluster serverless.

true

ScaleRoNumMin

string

No

Jumlah minimum node read-only untuk skalabilitas otomatis. Nilai yang valid: 0 hingga 15.

Catatan

Parameter ini hanya berlaku untuk kluster serverless.

2

ScaleRoNumMax

string

No

Jumlah maksimum node read-only untuk skalabilitas otomatis. Nilai yang valid: 0 hingga 15.

Catatan

Parameter ini hanya berlaku untuk kluster serverless.

4

StorageType

string

No

Kelas penyimpanan kluster Edisi Perusahaan. Nilai yang valid:

  • PSL5

  • PSL4

Kelas penyimpanan kluster Edisi Standar. Nilai yang valid:

  • ESSDPL0

  • ESSDPL1

  • ESSDPL2

  • ESSDPL3

  • ESSDAUTOPL

PSL4

DBNodeNum

integer

No

Jumlah node untuk kluster Edisi Standar atau Edisi Perusahaan. Nilai yang valid:

  • Edisi Standar: 1 hingga 8. Anda dapat menambahkan satu node baca/tulis dan tujuh node read-only.

  • Edisi Perusahaan: 1 hingga 16. Anda dapat menambahkan satu node baca/tulis dan 15 node read-only.

Catatan
  • Secara default, kluster Edisi Perusahaan memiliki dua node, dan kluster Edisi Standar memiliki satu node.

  • Parameter ini hanya berlaku untuk PolarDB untuk MySQL.

  • Anda tidak dapat mengubah jumlah node untuk Kluster Multi-master.

1

HotStandbyCluster

string

No

Menentukan apakah akan mengaktifkan fitur kluster hot standby. Nilai yang valid:

  • ON (default): mengaktifkan fitur klaster penyimpanan siaga panas.

  • OFF: menonaktifkan fitur kluster hot standby.

  • STANDBY: mengaktifkan fitur Hot Standby Cluster.

  • EQUAL: mengaktifkan hot standby untuk penyimpanan dan komputasi.

  • 3AZ: mengaktifkan konsistensi kuat untuk data multi-zona.

Catatan

STANDBY hanya berlaku untuk PolarDB untuk PostgreSQL.

ON

StrictConsistency

string

No

Menentukan apakah akan mengaktifkan konsistensi kuat untuk data multi-zona. Nilai yang valid:

  • ON: mengaktifkan konsistensi kuat untuk data multi-zona. Nilai ini berlaku untuk skenario 3AZ Edisi Standar.

  • OFF: menonaktifkan konsistensi kuat untuk data multi-zona.

ON

StandbyAZ

string

No

Zona kluster hot standby.

Catatan

Parameter ini hanya berlaku jika Anda mengaktifkan fitur kluster hot standby atau konsistensi kuat untuk data multi-zona.

cn-hangzhou-g

ProxyType

string

No

Jenis proksi database. Nilai yang valid:

  • EXCLUSIVE: Edisi Perusahaan Khusus

  • GENERAL: Edisi Perusahaan Standar

Catatan

Jenis proksi harus konsisten dengan jenis spesifikasi node kluster. Contohnya:

  • Jika spesifikasi node bersifat tujuan umum, jenis proksi harus Edisi Perusahaan Standar.

  • Jika spesifikasi node bersifat spesifikasi khusus, jenis proksi harus Edisi Perusahaan Khusus.

Exclusive

ProxyClass

string

No

Spesifikasi proksi database untuk kluster Edisi Standar. Nilai yang valid:

  • polar.maxscale.g2.medium.c: 2 core.

  • polar.maxscale.g2.large.c: 4 core.

  • polar.maxscale.g2.xlarge.c: 8 core.

  • polar.maxscale.g2.2xlarge.c: 16 core.

  • polar.maxscale.g2.3xlarge.c: 24 core.

  • polar.maxscale.g2.4xlarge.c: 32 core.

  • polar.maxscale.g2.8xlarge.c: 64 core.

polar.maxscale.g2.medium.c

LoosePolarLogBin

string

No

Menentukan apakah akan mengaktifkan binary logging. Nilai yang valid:

  • ON: mengaktifkan binary logging untuk kluster.

  • OFF: menonaktifkan binary logging untuk kluster.

Catatan

Parameter ini hanya berlaku jika Anda mengatur DBType ke MySQL.

ON

LooseXEngine

string

No

Menentukan apakah akan mengaktifkan mesin penyimpanan X-Engine. Nilai yang valid:

  • ON: mengaktifkan mesin penyimpanan X-Engine untuk kluster.

  • OFF: menonaktifkan mesin penyimpanan X-Engine untuk kluster.

Catatan

Parameter ini hanya berlaku jika Anda mengatur CreationOption ke nilai selain CreateGdnStandby, DBType ke MySQL, dan DBVersion ke 8.0. Memori node dengan X-Engine yang diaktifkan harus 8 GB atau lebih besar.

ON

LooseXEngineUseMemoryPct

string

No

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

Catatan

Parameter ini hanya berlaku jika Anda mengatur LooseXEngine ke ON.

50

StoragePayType

string

No

Metode penagihan untuk penyimpanan. Nilai yang valid:

  • Postpaid: pay-as-you-go berdasarkan kapasitas penyimpanan.

  • Prepaid: subscription berdasarkan ruang penyimpanan.

Prepaid

StorageAutoScale

string

No

Menentukan apakah akan mengaktifkan skalabilitas otomatis penyimpanan untuk kluster Edisi Standar. Nilai yang valid:

  • Enable: mengaktifkan skalabilitas otomatis penyimpanan.

  • Disable: menonaktifkan skalabilitas otomatis penyimpanan.

Enable

StorageUpperBound

integer

No

Batas atas ruang penyimpanan untuk skalabilitas otomatis kluster Edisi Standar. Satuan: GB.

Catatan

Nilai maksimum adalah 32.000.

800

ProvisionedIops

integer

No

1000

BurstingEnabled

string

No

Menentukan apakah akan mengaktifkan fitur lonjakan performa untuk disk ESSD AutoPL. Nilai yang valid:

  • true: mengaktifkan fitur tersebut.

  • false: menonaktifkan fitur tersebut. Ini adalah nilai default.

Catatan

Parameter ini hanya berlaku ketika Anda mengatur StorageType ke ESSDAUTOPL.

false

TargetMinorVersion

string

No

StorageEncryption

boolean

No

Menentukan apakah akan mengaktifkan enkripsi disk. Nilai yang valid:

  • true: mengaktifkan enkripsi disk.

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

Catatan

Parameter ini hanya berlaku jika Anda mengatur DBType ke MySQL.

Catatan

Parameter ini hanya berlaku ketika parameter StorageType diatur ke kelas penyimpanan Edisi Standar.

StorageEncryptionKey

string

No

ID kunci kustom untuk enkripsi disk di wilayah yang sama dengan instans. Jika Anda menentukan parameter ini, enkripsi disk akan diaktifkan secara otomatis. Setelah enkripsi disk diaktifkan, tidak dapat dinonaktifkan. Jika Anda ingin menggunakan kunci layanan default untuk enkripsi disk, biarkan parameter ini kosong.

Anda dapat melihat ID kunci atau membuat kunci di Konsol Key Management Service (KMS).

Catatan

Parameter ini hanya berlaku jika Anda mengatur DBType ke MySQL.

Catatan

Parameter ini hanya berlaku ketika parameter StorageType diatur ke kelas penyimpanan Edisi Standar.

SourceUid

integer

No

UID akun yang memiliki set cadangan sumber. Parameter ini wajib untuk backup dan pemulihan lintas akun.

1022xxxxxxxx

CloudProvider

string

No

Penyedia layanan cloud instans.

ENS

EnsRegionId

string

No

ID node Edge Node Service (ENS). Parameter ini wajib saat Anda membuat database ENS.

vn-hanoi-3

AutoUseCoupon

boolean

No

Menentukan apakah akan secara otomatis menggunakan kupon. Nilai yang valid:

  • true (default): secara otomatis menggunakan kupon.

  • false: tidak menggunakan kupon.

true

PromotionCode

string

No

Kode promosi. Jika Anda tidak menentukan parameter ini, kupon default akan digunakan.

727xxxxxx934

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-***************

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidBackupRetentionPolicyOnClusterDeletion.Malformed The specified BackupRetentionPolicyOnClusterDeletion is invalid.
400 InvalidLowerCaseTableNames.Malformed The specified LowerCaseTableNames is invalid.
400 InvalidDefaultTimeZone.Malformed The specified DefaultTimeZone is invalid.
400 Location.FailedGetSubDomain The specified regionId does not match the zoneId or the zoneId does not exist.
400 MissParameter.GDNId The GDNId parameter is required.
400 EntityNotExist.ResourceGroup The resource group does not exist..

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.