All Products
Search

This Product

    PolarDB:CreateDatabase

    Document Center

    PolarDB:CreateDatabase

    Last Updated:Jun 10, 2026

    Membuat database untuk Kluster PolarDB Basis Data Relasional Cloud-Native.

    Deskripsi operasi

    Before you call this operation, make sure that the following requirements are met:

    • The cluster is in the Running state.

    • The cluster is unlocked.

    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:CreateDatabase

    create

    *DBCluster

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBClusterId

    string

    Yes

    ID kluster.

    pc-**************
    DBName

    string

    Yes

    Nama database. Nama harus memenuhi persyaratan berikut:

    • Nama dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

    • Nama harus diawali dengan huruf kecil dan diakhiri dengan huruf kecil atau angka. Panjang nama harus 1 hingga 64 karakter.

    Catatan

    Jangan gunakan kata yang dicadangkan sebagai nama database, seperti test atau mysql.

    testDB
    CharacterSetName

    string

    Yes

    Set karakter yang digunakan oleh Kluster. Untuk informasi selengkapnya, lihat Tabel set karakter.

    utf8
    DBDescription

    string

    No

    Deskripsi database. Deskripsi harus memenuhi persyaratan berikut:

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

    • Panjangnya harus 2 hingga 256 karakter.

    Catatan

    Parameter ini wajib untuk Kluster PolarDB Basis Data Relasional Cloud-Native for Oracle atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL. Parameter ini bersifat opsional untuk Kluster PolarDB Basis Data Relasional Cloud-Native for MySQL.

    testdesc
    AccountName

    string

    No

    Nama akun yang diberi izin untuk mengakses database. Anda dapat memanggil operasi DescribeAccounts untuk mengkueri informasi akun.

    Catatan

    • Anda hanya dapat menentukan akun standar. Secara default, akun istimewa memiliki semua izin pada semua database. Anda tidak perlu memberikan izin akses database kepada akun istimewa.

    • Parameter ini wajib untuk Kluster PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL. Parameter ini bersifat opsional untuk Kluster PolarDB Basis Data Relasional Cloud-Native for MySQL.

    testacc
    AccountPrivilege

    string

    No

    Izin yang diberikan kepada akun. Nilai valid:

    • ReadWrite: izin baca dan tulis.

    • ReadOnly: izin hanya baca.

    • DMLOnly: izin hanya untuk mengeksekusi pernyataan DML pada database.

    • DDLOnly: izin hanya untuk mengeksekusi pernyataan DDL pada database.

    • ReadIndex: izin hanya baca dan Indeks.

    Nilai default adalah ReadWrite.

    Catatan

    • Parameter ini hanya valid ketika parameter AccountName ditentukan.

    • Untuk Kluster PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL, parameter ini bersifat opsional. Jika AccountName ditentukan, parameter ini adalah akun Pemilik database.

    • Untuk Kluster PolarDB Basis Data Relasional Cloud-Native for MySQL, parameter ini bersifat opsional.

    ReadWrite
    Collate

    string

    No

    Bahasa yang menentukan Aturan pengurutan dalam database.

    Catatan

    • Bahasa harus kompatibel dengan set karakter yang ditentukan oleh CharacterSetName.

    • Parameter ini wajib untuk Kluster PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL. Parameter ini bersifat opsional untuk Kluster PolarDB Basis Data Relasional Cloud-Native for MySQL. Untuk Tampilan nilai valid parameter ini, lakukan langkah berikut: Masuk ke Konsol PolarDB Basis Data Relasional Cloud-Native dan klik ID Kluster. Di panel navigasi sebelah kiri, pilih Pengaturan dan Manajemen > Database. Lalu, klik Buat Database.

    C
    Ctype

    string

    No

    Bahasa yang menunjukkan tipe karakter database.

    Catatan

    • Bahasa harus kompatibel dengan set karakter yang ditentukan oleh CharacterSetName.

    • Nilai yang Anda tentukan harus sama dengan nilai Collate.

    • Parameter ini wajib untuk Kluster PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) atau PolarDB Basis Data Relasional Cloud-Native for PostgreSQL. Parameter ini bersifat opsional untuk Kluster PolarDB Basis Data Relasional Cloud-Native for MySQL.

    Untuk Tampilan nilai valid parameter ini, lakukan langkah berikut: Masuk ke Konsol PolarDB Basis Data Relasional Cloud-Native dan klik ID Kluster. Di panel navigasi sebelah kiri, pilih Pengaturan dan Manajemen > Database. Lalu, klik Buat Database.

    C

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The ID of the request.

    93E98F25-BE02-40DA-83E3-F77F8D******

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "93E98F25-BE02-40DA-83E3-F77F8D******"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDBName.Malformed The specified parameter DBName is not valid.
    400 Database.AddError Instance %s add database minidoc error
    400 InvalidDBDescription.Malformed The specified parameter DBDescription is not valid.
    400 InvalidAccountPrivilege.Malformed The specified parameter AccountPrivilege is not valid.
    400 InvalidAccountName.Malformed The specified parameter AccountName is not valid.
    404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records.
    404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.
    404 InvalidDBClusterId.NotFound The DBInstanceId provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.