Anda dapat memanggil operasi CreateDatabase untuk membuat database pada sebuah instans.
Jika Anda ingin melakukan tugas manajemen data seperti perubahan data dan desain skema, gunakan Data Management (DMS). Untuk informasi selengkapnya, lihat Daftar operasi berdasarkan fungsi DMS.
Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:
- Instans berada dalam status Running.
- Jumlah maksimum database untuk instans tersebut belum tercapai. Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk mengetahui jumlah maksimum database.
- Instans bukan merupakan read-only instance.Catatan Operasi ini tidak didukung untuk instans yang menjalankan SQL Server 2017 EE (cluster edition) atau instans yang menjalankan PostgreSQL dan menggunakan SSD lokal. Jika instans menjalankan salah satu versi mesin database tersebut, Anda dapat mengeksekusi pernyataan CREATE DATABASE untuk membuat database.
Debugging
Parameter permintaan
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | CreateDatabase | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateDatabase. |
| DBInstanceId | String | Yes | rm-uf6wjk5xxxxxxxxxx | ID instans. |
| DBName | String | Yes | rds_mysql | Nama database. Catatan
|
| CharacterSetName | String | Yes | gbk | Set karakter.
|
| DBDescription | String | No | Test database | Deskripsi database. Deskripsi harus terdiri dari 2 hingga 256 karakter dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Deskripsi harus dimulai dengan huruf. Catatan Deskripsi tidak boleh dimulai dengan http:// atau https://. |
| ResourceGroupId | String | No | rg-acfmy***** | ID kelompok sumber daya. |
Parameter respons
| Parameter | Type | Example | Description |
| RequestId | String | 5A77D650-27A1-4E08-AD9E-59008EDB6927 | ID permintaan. |
Contoh
Contoh permintaan
http(s)://rds.aliyuncs.com/?Action=CreateDatabase
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&DBName=rds_mysql
&CharacterSetName=gbk
&<Common request parameters>Contoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateDatabaseResponse>
<RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}Kode kesalahan
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Deskripsi |
| 400 | EngineMigration.ActionDisabled | Specified action is disabled while custins is in engine migration. | Pesan kesalahan yang dikembalikan karena operasi yang ditentukan dinonaktifkan selama migrasi mesin untuk instans tersebut. |
| 400 | Database.AddError | Create Db failed, please check input value and instance status | Pesan kesalahan yang dikembalikan karena pembuatan database gagal. Periksa parameter input dan status instans. |
| 400 | Database.ConnectError | Database connect error. please check instance status and database processlist | Pesan kesalahan yang dikembalikan karena koneksi database tidak normal. Periksa status instans dan kolam koneksi database. |
Untuk daftar kode kesalahan, kunjungi API Error Center.