All Products
Search

This Product

    PolarDB:CreateDBClusterEndpoint

    Document Center

    PolarDB:CreateDBClusterEndpoint

    Last Updated:Jul 02, 2026

    Membuat titik akhir kluster kustom untuk kluster PolarDB Basis Data Relasional Cloud-Native.

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

    create

    *DBCluster.

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBClusterId

    string

    Yes

    ID kluster.

    pc-**************
    EndpointType

    string

    Yes

    Tipe titik akhir kluster kustom. Nilai valid:

    • Custom: titik akhir kluster kustom.

    • DynamoDB: titik akhir DynamoDB.

    Custom
    Nodes

    string

    No

    Node beban baca yang akan ditambahkan ke titik akhir. Pisahkan beberapa node dengan koma (,). Secara default, semua node ditambahkan.

    Catatan

    • Untuk PolarDB Basis Data Relasional Cloud-Native for MySQL, tentukan ID node.

    • Untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle), tentukan nama peran node, seperti Writer,Reader1,Reader2.

    • Jika ReadWriteMode diatur ke ReadOnly, Anda hanya dapat memasang satu node. Namun, jika node ini gagal, titik akhir mungkin tidak tersedia hingga 1 jam. Jangan gunakan konfigurasi ini di lingkungan produksi. Pilih setidaknya 2 node untuk meningkatkan ketersediaan.

    • Jika ReadWriteMode diatur ke ReadWrite, pilih setidaknya 2 node. * Untuk PolarDB Basis Data Relasional Cloud-Native for MySQL, Anda dapat memilih dua node apa pun. Jika kedua node adalah node baca-saja, permintaan tulis diteruskan ke node utama. * Untuk PolarDB Basis Data Relasional Cloud-Native for PostgreSQL dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle), node utama harus disertakan.

    pi-**********,pi-*********
    ReadWriteMode

    string

    No

    Mode baca/tulis. Nilai valid:

    • ReadWrite: baca/tulis (pemisahan baca/tulis otomatis).

    • ReadOnly (default): baca-saja.

    ReadOnly
    AutoAddNewNodes

    string

    No

    Apakah akan menambahkan node baru secara otomatis ke titik akhir ini. Nilai valid:

    • Enable: Node baru ditambahkan secara otomatis ke titik akhir ini.

    • Disable (default): Node baru tidak ditambahkan secara otomatis ke titik akhir ini.

    Disable
    EndpointConfig

    string

    No

    Konfigurasi lanjutan titik akhir kluster dalam format JSON. Anda dapat mengonfigurasi tingkat konsistensi, pemisahan transaksi, offload baca dari node utama, dan pengaturan pooling koneksi.

    • Kebijakan load balancing. Format: {"LoadBalancePolicy":"Kebijakan load balancing"}. Nilai valid:

      • 0: load balancing berbasis koneksi (default).

      • 1: load balancing berbasis permintaan aktif.

    • Tingkat konsistensi. Format: {"ConsistLevel":"Tingkat konsistensi"}. Nilai valid:

      • 0: konsistensi akhir.

      • 1: konsistensi sesi (default).

      • 2: konsistensi global.

    • Pemisahan transaksi. Format: {"DistributedTransaction":"Pemisahan transaksi"}. Nilai valid:

      • on: mengaktifkan pemisahan transaksi (default).

      • off: menonaktifkan pemisahan transaksi.

    • Offload baca dari node utama. Format: {"MasterAcceptReads":"Offload baca dari node utama"}. Nilai valid:

      • on: node utama menerima permintaan baca.

      • off: node utama tidak menerima permintaan baca (default).

    • Kolam koneksi. Format: {"ConnectionPersist":"Kolam koneksi"}. Nilai valid:

      • off: menonaktifkan kolam koneksi (default).

      • Session: mengaktifkan pooling koneksi tingkat sesi.

      • Transaction: mengaktifkan pooling koneksi tingkat transaksi.

    • Kueri paralel. Format: {"MaxParallelDegree":"Kueri paralel"}. Nilai valid:

      • Tingkat paralelisme tertentu. Contoh: "MaxParallelDegree":"2".

      • off: menonaktifkan kueri paralel (default).

    • Distribusi permintaan otomatis di antara node penyimpanan baris dan penyimpanan kolom. Format: {"EnableHtapImci":"Distribusi permintaan otomatis di antara node penyimpanan baris dan penyimpanan kolom"}. Nilai valid:

      • on: mengaktifkan distribusi permintaan otomatis di antara node penyimpanan baris dan penyimpanan kolom.

      • off: menonaktifkan distribusi permintaan otomatis di antara node penyimpanan baris dan penyimpanan kolom (default).

    • Perlindungan kelebihan beban. Format: {"EnableOverloadThrottle":"Perlindungan kelebihan beban"}. Nilai valid:

      • on: mengaktifkan perlindungan kelebihan beban.

      • off: menonaktifkan perlindungan kelebihan beban (default).

    Catatan

    • Pemisahan transaksi, offload baca dari node utama, kolam koneksi, dan perlindungan kelebihan beban hanya dapat dikonfigurasi ketika mode baca/tulis titik akhir kluster PolarDB Basis Data Relasional Cloud-Native for MySQL adalah ReadWrite (pemisahan baca/tulis otomatis).

    • Ketika mode baca/tulis titik akhir kluster PolarDB Basis Data Relasional Cloud-Native for MySQL adalah ReadOnly, load balancing berbasis koneksi dan load balancing berbasis permintaan aktif didukung. Mode ReadWrite (pemisahan baca/tulis otomatis) hanya mendukung load balancing berbasis permintaan aktif.

    • Distribusi permintaan otomatis di antara node penyimpanan baris dan penyimpanan kolom dapat dikonfigurasi ketika mode baca/tulis titik akhir kluster PolarDB Basis Data Relasional Cloud-Native for MySQL adalah ReadWrite (pemisahan baca/tulis otomatis), atau ketika mode baca/tulis adalah ReadOnly dan kebijakan load balancing adalah load balancing berbasis permintaan aktif.

    • Hanya PolarDB Basis Data Relasional Cloud-Native for MySQL yang mendukung pengaturan tingkat konsistensi ke konsistensi global.

    • Jika ReadWriteMode diatur ke ReadOnly, tingkat konsistensi hanya dapat diatur ke 0.

    • Anda dapat mengonfigurasi tingkat konsistensi, pemisahan transaksi, offload baca dari node utama, dan kolam koneksi secara bersamaan. Contoh: {"ConsistLevel":"1","DistributedTransaction":"on","ConnectionPersist":"Session","MasterAcceptReads":"on"}.

    • Pemisahan transaksi dibatasi oleh tingkat konsistensi. Misalnya, pemisahan transaksi tidak dapat diaktifkan ketika tingkat konsistensi adalah 0. Pemisahan transaksi dapat diaktifkan ketika tingkat konsistensi adalah 1 atau 2.

    {"ConsistLevel": "1","DistributedTransaction": "on"}
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan dan mencegah pengiriman berulang. Token dihasilkan oleh klien, harus unik di seluruh permintaan, bersifat case-sensitive, dan panjangnya tidak boleh melebihi 64 karakter ASCII.

    6000170000591aed949d0f******************
    DBEndpointDescription

    string

    No

    Nama titik akhir kluster kustom.

    test
    VPCId

    string

    No

    ID VPC.

    vpc-2zehr7ghqovftils0****
    VSwitchId

    string

    No

    ID vSwitch.

    vsw-2ze775gnf7jn33ua****
    SccMode

    string

    No

    Apakah akan mengaktifkan fitur konsistensi global (mode kinerja tinggi) untuk node. Nilai valid:

    • ON: diaktifkan.

    • OFF: dinonaktifkan.

    on
    PolarSccWaitTimeout

    string

    No

    Periode pengatur waktu untuk konsistensi global.

    100
    PolarSccTimeoutAction

    string

    No

    Kebijakan pengatur waktu untuk konsistensi global. Nilai valid:

    • 0: mengirimkan permintaan ke node utama.

    • 2: degradasi pengatur waktu. Setelah pembacaan konsistensi global mengalami pengatur waktu, kueri secara otomatis didegradasi menjadi permintaan reguler, dan klien tidak menerima Paket error.

    0
    PolarFsInstanceId

    string

    No

    ID instans PolarFs.

    pfs-test****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    CD35F3-F3-44CA-AFFF-BAF869******

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "CD35F3-F3-44CA-AFFF-BAF869******"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 ClusterEndpoint.StatusNotValid Cluster endpoint status is not valid. Status titik akhir kluster tidak valid.
    400 EndpointNum.Error Endpoint number error. Jumlah titik akhir melebihi batas.
    400 LockTimeout The request processing has failed due to lock timeout. Permintaan gagal diproses karena timeout kunci.
    403 OperationDenied.InstanceType The operation is not permitted due to instance type. Operasi tidak diizinkan karena tipe instans.
    404 EndpointConfig.Invalid Endpoint config is invalid. Parameter konfigurasi lanjutan titik akhir kluster tidak valid.
    404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records. DBClusterId yang ditentukan tidak ada dalam catatan saat ini.
    404 EndpointConfig.Conflict Endpoint config is invalid, CausalConsistRead should be session since node SCC mode enabled. Konfigurasi titik akhir tidak valid. CausalConsistRead harus diatur ke Sesi karena konsistensi global (mode kinerja tinggi) diaktifkan untuk node.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.