ApsaraDB RDS:CreateDBInstance

ID region. Anda dapat memanggil DescribeRegions untuk menanyakan ID region.

Mesin basis data. Nilai yang valid:

• MySQL

• SQLServer

• PostgreSQL

• MariaDB

Versi mesin basis data. Nilai yang valid:

• Instans reguler

  • MySQL: 5.5, 5.6, 5.7, 8.0

  • SQL Server: 08r2_ent_ha (edisi cloud disk, tidak lagi tersedia untuk dijual), 2008r2 (local disk performa tinggi, tidak lagi tersedia untuk dijual), 2012 (Enterprise Basic Edition), 2012_ent_ha, 2012_std_ha, 2012_web, 2014_ent_ha, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_ent, 2017_std_ha, 2017_web, 2019_ent, 2019_std_ha, 2019_web, 2022_ent, 2022_std_ha, 2022_web

  • PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0, 18.0

  • MariaDB: 10.3, 10.6

• Instans serverless

  • MySQL: 5.7, 8.0

  • SQL Server: 2016_std_sl, 2017_std_sl, 2019_std_sl

  • PostgreSQL: 14.0, 15.0, 16.0, 17.0, 18.0

Tipe instans. Anda dapat menentukan tipe instans standar atau Yitian. Untuk informasi lebih lanjut, lihat Tipe instans utama.

Untuk membuat instans serverless, atur parameter ini ke salah satu nilai berikut:

• MySQL Basic Edition: mysql.n2.serverless.1c

• MySQL High-availability Edition: mysql.n2.serverless.2c

• SQL Server: mssql.mem2.serverless.s2

• PostgreSQL Basic Edition: pg.n2.serverless.1c

• PostgreSQL High-availability Edition: pg.n2.serverless.2c

Kapasitas penyimpanan instans. Satuan: GB. Nilai harus kelipatan 5. Untuk rentang nilai, lihat Tipe instans.

Parameter yang sudah usang. Anda tidak perlu menentukan parameter ini.

Tipe koneksi jaringan instans. Atur nilainya ke Intranet, yang menunjukkan koneksi jaringan internal.

Nama instans. Nama harus terdiri dari 2 hingga 255 karakter. Harus diawali dengan huruf (Tionghoa atau Inggris) dan dapat berisi digit, karakter Tionghoa, huruf Inggris, dan tanda hubung (-).

IP whitelist instans. Pisahkan beberapa entri dengan koma (,). Entri tidak boleh duplikat. Hingga 1.000 alamat IP atau blok CIDR dapat ditambahkan ke satu instans. Dua format berikut didukung:

• Format alamat IP, misalnya, 10.10.XX.XX.

• Format CIDR, misalnya, 10.10.XX.XX/24 (Classless Inter-Domain Routing, di mana 24 menunjukkan panjang prefix dalam alamat. Rentangnya adalah 1 hingga 32).

Token klien yang digunakan untuk memastikan idempotensi permintaan dan mencegah pengiriman permintaan duplikat. Nilai dihasilkan oleh klien dan harus unik di antara permintaan yang berbeda. Nilai dapat berisi hingga 64 karakter ASCII dan tidak boleh berisi karakter non-ASCII.

Metode penagihan instans. Nilai yang valid:

• Postpaid: bayar sesuai pemakaian.

• Prepaid: berlangganan.

• Serverless: serverless. Nilai ini tidak didukung untuk instans MariaDB. Untuk informasi lebih lanjut, lihat Gambaran umum instans MySQL Serverless, Gambaran umum instans SQL Server Serverless, dan Gambaran umum instans PostgreSQL Serverless.

ID zona node primer.

• Jika Anda menentukan VPC dan vSwitch, Anda harus menentukan ID zona dari vSwitch target. Jika tidak, instans tidak dapat dibuat.

• Untuk instans High-availability Edition, Anda juga harus menentukan ZoneIdSlave1 untuk menentukan apakah instans dideploy di satu zona atau di beberapa zona.

• Untuk instans Three-Node Enterprise Edition, Anda juga harus menentukan ZoneIdSlave1 dan ZoneIdSlave2 untuk menentukan apakah instans dideploy di satu zona atau di beberapa zona.

• Untuk instans RDS Cluster Edition, Anda harus menentukan ZoneIdSlave1 untuk instans dua node, dan menentukan ZoneIdSlave1 dan ZoneIdSlave2 untuk instans tiga node.

ID zona node sekunder.

• Jika Anda menentukan Auto, deployment multi-zona digunakan dan zona dipilih secara otomatis untuk node sekunder.

• Jika nilainya sama dengan ZoneId, deployment zona tunggal digunakan.

• Jika nilainya berbeda dari ZoneId, deployment multi-zona digunakan.

Instans RDS MySQL Cluster Edition mendukung pembuatan 1 atau 2 node sekunder saat instans baru dibuat. Jika Anda memiliki kebutuhan ini, Anda dapat menggunakan parameter ini untuk menentukan zona dari node sekunder kedua.

Tipe jaringan instans. Nilai yang valid:

• VPC: virtual private cloud (VPC).

• Classic: jaringan klasik.

Mode akses instans. Nilai yang valid:

• Standard: mode standar.

• Safe: mode database proxy.

Secara default, mode akses ditetapkan oleh RDS.

ID virtual private cloud (VPC).

ID vSwitch.

• Pemetaan zona: Zona dari VSwitchId harus sesuai dengan zona node primer (ZoneId) dan zona node sekunder (ZoneIdSlave1). Jika Anda menentukan dua ID vSwitch, urutannya harus sesuai dengan ZoneId dan ZoneSlaveId1.

• Pembatasan tipe jaringan: Tipe jaringan InstanceNetworkType harus VPC.

• Persyaratan beberapa vSwitch: Jika Anda menentukan ZoneSlaveId1 (ID zona node sekunder) dan nilainya bukan Auto, Anda harus menentukan dua ID vSwitch yang dipisahkan dengan koma (,).

• Pembatasan karakter: VSwitchId tidak boleh berisi karakter khusus seperti spasi, !, #, ¥, &, atau %.

Menetapkan alamat IP internal instans. Alamat IP harus berada dalam rentang alamat IP dari vSwitch yang ditentukan. Secara default, sistem secara otomatis menetapkan alamat IP berdasarkan VPCId dan vSwitchId.

Durasi pembelian. Nilai yang valid:

• Jika Period diatur ke Year, UsedTime dapat diatur ke nilai dari 1 hingga 5.

• Jika Period diatur ke Month, UsedTime dapat diatur ke nilai dari 1 hingga 11.

Menentukan apakah instans berlangganan adalah berlangganan tahunan atau bulanan. Nilai yang valid:

• Year

• Month

ID grup sumber daya.

Tipe penyimpanan instans. Nilai yang valid:

• local_ssd: local disk performa tinggi (direkomendasikan).

• general_essd: general-purpose Enterprise SSD (ESSD) (direkomendasikan).

• cloud_essd: ESSD PL1.

• cloud_essd2: ESSD PL2.

• cloud_essd3: ESSD PL3.

• cloud_ssd: SSD standar (tidak direkomendasikan, tidak lagi tersedia untuk dijual di beberapa region).

Nilai default parameter ini ditentukan secara otomatis berdasarkan tipe instans yang ditentukan dalam DBInstanceClass:

• Jika tipe instans adalah tipe local disk performa tinggi, nilai default adalah local_ssd.

• Jika tipe instans adalah tipe cloud disk, nilai default adalah cloud_essd.

Parameter ekstensi bisnis.

ID kunci yang digunakan untuk enkripsi cloud disk di region yang sama. Menentukan parameter ini mengaktifkan enkripsi cloud disk (yang tidak dapat dinonaktifkan setelah diaktifkan), dan Anda juga harus menentukan RoleARN.

Anda dapat melihat ID kunci di konsol Key Management Service (KMS), atau Anda dapat membuat kunci baru. Untuk informasi lebih lanjut, lihat Membuat kunci.

Alibaba Cloud Resource Name (ARN) yang disediakan oleh akun Alibaba Cloud untuk mengizinkan akun layanan RDS mengakses KMS. Anda dapat melihat informasi ARN dengan memanggil operasi CheckCloudResourceAuthorized.

Menentukan apakah akan mengaktifkan perpanjangan otomatis untuk instans. Parameter ini hanya ditentukan ketika Anda membuat instans berlangganan. Nilai yang valid:

• true

• false

Edisi RDS dari instans. Nilai yang valid:

• Instans reguler

  • Basic: Basic Edition.

  • HighAvailability: High-availability Edition.

  • cluster: MySQL atau PostgreSQL Cluster Edition.

  • AlwaysOn: SQL Server Cluster Edition.

  • Finance: Three-Node Enterprise Edition.

  Catatan

  Parameter ini diperlukan ketika Anda membuat SQL Server Enterprise Cluster Edition. Misalnya, ketika Anda membuat Basic Edition 2022 Enterprise Cluster Edition (2022_ent), parameter ini harus diatur ke Basic.

• Instans serverless

  • serverless_basic: Serverless Basic Edition. (Hanya berlaku untuk MySQL dan PostgreSQL.)

  • serverless_standard: Serverless High-availability Edition. (Hanya berlaku untuk MySQL dan PostgreSQL.)

  • serverless_ha: SQL Server Serverless High-availability Edition.

  Catatan

  Parameter ini diperlukan ketika PayType diatur ke Serverless.

ID dedicated host cluster.

Parameter ini diperlukan ketika Anda membuat instans RDS dalam dedicated cluster.

• Anda dapat memanggil operasi DescribeDedicatedHostGroups untuk menanyakan informasi grup host RDS.

• Jika Anda belum membuat grup host RDS, Anda dapat memanggil operasi CreateDedicatedHostGroup untuk membuatnya.

ID host instans primer dalam dedicated cluster.

Parameter ini diperlukan ketika Anda membuat instans RDS dalam dedicated cluster. Jika Anda tidak menentukan parameter ini, sistem secara otomatis menetapkan host secara default.

• Anda dapat memanggil operasi DescribeDedicatedHosts untuk menanyakan informasi host di grup host RDS.

• Jika Anda tidak memiliki host, Anda dapat memanggil operasi CreateDedicatedHost untuk menambahkannya.

ID host instans sekunder dalam dedicated cluster.

Parameter ini diperlukan ketika Anda membuat instans RDS High-availability Edition atau Three-Node Enterprise Edition dalam dedicated cluster. Jika Anda tidak menentukan parameter ini, sistem secara otomatis menetapkan host secara default.

• Anda dapat memanggil operasi DescribeDedicatedHosts untuk menanyakan informasi host di RDS dedicated cluster.

• Jika Anda tidak memiliki host, Anda dapat memanggil operasi CreateDedicatedHost untuk menambahkannya.

ID host instans log dalam dedicated cluster.

Parameter ini diperlukan ketika Anda membuat instans RDS Three-Node Enterprise Edition dalam dedicated cluster. Jika Anda tidak menentukan parameter ini, sistem secara otomatis menetapkan host secara default.

• Anda dapat memanggil operasi DescribeDedicatedHosts untuk menanyakan informasi host di RDS dedicated cluster.

• Jika Anda tidak memiliki host, Anda dapat memanggil operasi CreateDedicatedHost untuk menambahkannya.

ID template parameter. Anda dapat memanggil operasi DescribeParameterGroups untuk menanyakan ID.

Mengatur zona waktu instans. Parameter ini hanya berlaku ketika Engine diatur ke MySQL atau PostgreSQL.

• Ketika Engine diatur ke MySQL:

  • Parameter ini digunakan untuk mengatur zona waktu UTC. Rentang nilainya adalah -12:59 hingga +13:00.

  • Instans local disk performa tinggi dapat menggunakan zona waktu bernama, seperti Asia/Hong_Kong. Untuk informasi lebih lanjut tentang zona waktu bernama, lihat Referensi zona waktu bernama.

• Ketika Engine diatur ke PostgreSQL:

  • Parameter ini digunakan untuk mengatur zona waktu bernama dan tidak mendukung zona waktu UTC. Untuk informasi lebih lanjut tentang zona waktu bernama, lihat Referensi zona waktu bernama.

  • Parameter ini hanya dapat dikonfigurasi ketika instans adalah instans cloud disk PostgreSQL.

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

• true: case-insensitive (default).

• false: case-sensitive.

Menentukan versi minor engine dari instans RDS yang akan dibuat. Parameter ini diperlukan hanya ketika Anda membuat instans MySQL atau PostgreSQL. Format:

• MySQL: <instance_version>_<numeric_version_number>. Misalnya, rds_20200229, xcluster_20200229, atau xcluster80_20200229. Deskripsinya adalah sebagai berikut:

  • rds: High-availability Edition atau Basic Edition.

  • xcluster: MySQL 5.7 Three-Node Enterprise Edition.

  • xcluster80: MySQL 8.0 Three-Node Enterprise Edition.

  Catatan

  Anda dapat memanggil operasi DescribeDBMiniEngineVersions untuk menanyakan nomor versi numerik. Untuk perbedaan antar versi, lihat Catatan Rilis versi minor AliSQL.

• PostgreSQL: rds_postgres_<major_version>00_<minor_version_number>. Misalnya, rds_postgres_1400_20220830. Deskripsinya adalah sebagai berikut:

  • 1400: Versi mayor PostgreSQL adalah 14.

  • 20220830: Versi minor kernel AliPG. Anda dapat memanggil operasi DescribeDBMiniEngineVersions untuk menanyakannya. Untuk perbedaan antar versi, lihat Catatan Rilis versi minor PostgreSQL.

  Catatan

  Jika Babelfish diaktifkan di BabelfishConfig, format versi minor instans RDS PostgreSQL adalah: rds_postgres_MajorVersion00_AliPGKernelMinorVersion_babelfish.

Menentukan apakah akan mengaktifkan ekspansi penyimpanan otomatis. Parameter ini hanya didukung oleh MySQL dan PostgreSQL. Nilai yang valid:

• Enable

• Disable (default)

Ambang pemicu (dalam persentase) untuk ekspansi penyimpanan otomatis. Nilai yang valid:

• 10

• 20

• 30

• 40

• 50

Batas atas kapasitas penyimpanan total untuk ekspansi penyimpanan otomatis. Ekspansi otomatis tidak menyebabkan kapasitas penyimpanan total instans melebihi nilai ini. Satuan: GB.

Menentukan apakah akan melakukan dry run untuk operasi pembuatan instans ini. Nilai yang valid:

• true: melakukan dry run tanpa membuat instans. Item pemeriksaan meliputi parameter permintaan, format permintaan, batasan bisnis, dan inventaris.

• false: mengirim permintaan normal dan langsung membuat instans setelah pemeriksaan lulus (default).

ID backup pengguna. Anda dapat memanggil operasi ListUserBackupFiles untuk menanyakan ID. Anda dapat menentukan parameter ini untuk membuat instans berdasarkan backup pengguna.

Pembatasan berikut berlaku ketika Anda menentukan parameter ini:

• Parameter PayType harus diatur ke Postpaid.

• Parameter Engine harus diatur ke MySQL.

• Parameter EngineVersion harus diatur ke 5.7.

• Parameter Category harus diatur ke Basic.

Jumlah instans RDS MySQL yang akan dibuat. Parameter ini hanya berlaku untuk pembuatan massal instans RDS MySQL.

Rentang nilai: 1 hingga 20. Nilai default: 1.

Strategi pembuatan instans massal. Parameter ini hanya berlaku ketika parameter Amount lebih besar dari 1. Nilai yang valid:

• Atomicity (default): Atomik. Yaitu, semua instans dalam batch yang sama harus berhasil dibuat. Jika ada yang gagal, semua instans gagal dibuat.

• Partial: Non-atomik. Yaitu, pembuatan instans tidak dipengaruhi oleh instans lain dalam batch yang sama.

Menentukan apakah akan mengaktifkan fitur perlindungan pelepasan RDS. Parameter ini hanya didukung oleh instans bayar sesuai pemakaian. Nilai yang valid:

• true: diaktifkan.

• false: dinonaktifkan (default).

Konfigurasi Babelfish untuk RDS PostgreSQL.

Format konfigurasi: {"babelfishEnabled":"true","migrationMode":"xxxxxxx","masterUsername":"xxxxxxx","masterUserPassword":"xxxxxxxx"}

Deskripsi parameter adalah sebagai berikut:

• babelfishEnabled: menentukan apakah akan mengaktifkan Babelfish. Atur parameter ini ke true untuk mengaktifkannya. Secara default, Babelfish tidak diaktifkan jika parameter ini tidak dikonfigurasi.

• migrationMode: mode basis data. Atur ke single-db untuk mode basis data tunggal atau multi-db untuk mode multi-basis data.

• masterUsername: akun manajemen awal. Terdiri dari huruf kecil, digit, dan garis bawah, harus diawali dengan huruf, dan diakhiri dengan huruf atau digit. Panjang maksimum adalah 63 karakter dan tidak boleh diawali dengan pg.

• masterUserPassword: kata sandi akun manajemen. Terdiri dari huruf besar, huruf kecil, digit, dan karakter khusus. Setidaknya tiga tipe harus disertakan. Panjangnya adalah 8 hingga 32 karakter. Karakter khusus meliputi ! @ # $ % ^ & * () _ + - =.

Endpoint internal basis data.

Format: xxx.mysql.rds.aliyuncs.com, di mana xxx adalah awalan ID instans, seperti rm-uf6wjk5***.

Mendukung inisialisasi port saat membuat instans RDS. Rentang nilai:

• MySQL: 1000 hingga 65534

• PostgreSQL, SQL Server, MariaDB: 1000 hingga 5999

Parameter yang sudah usang. Anda tidak perlu menentukan parameter ini.

Menentukan apakah akan mengaktifkan fitur IO burst dari general-purpose ESSD. Nilai yang valid:

• true: diaktifkan.

• false: dinonaktifkan.

Menentukan apakah akan mengaktifkan pembayaran otomatis. Nilai yang valid:

• true: mengaktifkan pembayaran otomatis. Anda harus memastikan bahwa akun Anda memiliki saldo yang cukup.

• false: hanya menghasilkan pesanan tanpa memotong biaya.

Menentukan apakah akan mengaktifkan fitur Buffer Pool Extension (BPE) dari general-purpose ESSD. Nilai yang valid:

• 1: mengaktifkan fitur.

• 0: menonaktifkan fitur.

Menentukan apakah akan mengaktifkan fitur arsip data dari general-purpose ESSD. Nilai yang valid:

• true: diaktifkan.

• false: dinonaktifkan.

Daftar whitelist. Ketika Anda perlu mengkonfigurasi beberapa alamat IP, pisahkan beberapa alamat IP atau blok CIDR dengan koma. Tidak boleh ada spasi sebelum atau sesudah koma, misalnya, 192.168.0.1,172.16.213.9.

Menentukan apakah akan secara otomatis membuat proxy. Nilai yang valid:

• true: mengaktifkan pembuatan otomatis. Proxy default adalah general proxy.

• false: menonaktifkan pembuatan otomatis.

Menentukan apakah akan menggunakan kupon. Nilai yang valid:

• true: menggunakan kupon.

• false (default): tidak menggunakan kupon.

Kode kupon.

Menentukan apakah akan mengaktifkan fitur 16K atomic write. Nilai yang valid:

• optimized: diaktifkan.

• none (default): dinonaktifkan.

Menentukan apakah akan mengaktifkan atau menonaktifkan replikasi native RDS MySQL. Nilai yang valid:

• ON: diaktifkan.

• OFF: dinonaktifkan.