All Products
Search

This Product

    PolarDB:CreateDBNodes

    Document Center

    PolarDB:CreateDBNodes

    Last Updated:Jun 26, 2026

    Menambahkan node read-only ke 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:CreateDBNodes

    create

    *dbcluster

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-************
    DBClusterId

    string

    Yes

    ID kluster.

    pc-*************
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan nilai ini. Pastikan nilai tersebut unik di antara permintaan yang berbeda. Token ini bersifat case-sensitive dan hanya dapat berisi karakter ASCII. Panjang token dapat mencapai 64 karakter.

    6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
    EndpointBindList

    string

    No

    ID titik akhir kluster tempat Anda ingin menambahkan node baru. Jika Anda ingin menambahkan node ke beberapa titik akhir, pisahkan ID titik akhir dengan koma (,).

    Catatan

    • Anda dapat memanggil operasi DescribeDBClusterEndpoints untuk mengkueri detail titik akhir kluster, termasuk ID titik akhir.

    • Anda dapat menentukan ID titik akhir kluster default dan titik akhir kluster kustom.

    • Jika Anda membiarkan parameter ini kosong, node baru akan ditambahkan ke semua titik akhir kluster yang memiliki fitur Automatically Associate New Nodes diaktifkan (nilai AutoAddNewNodes adalah Enable).

    pe-****************,pe-****************
    PlannedStartTime

    string

    No

    Pengatur waktu paling awal untuk mulai menjalankan Tugas terjadwal penambahan node. Tentukan pengatur waktu dalam format YYYY-MM-DDThh:mm:ssZ (UTC).

    Catatan

    • Waktu mulai harus berada dalam 24 jam ke depan. Misalnya, jika pengatur waktu saat ini adalah 2021-01-14T09:00:00Z, Anda dapat menentukan Waktu mulai dalam rentang 2021-01-14T09:00:00Z hingga 2021-01-15T09:00:00Z.

    • Jika Anda membiarkan parameter ini kosong, Tugas penambahan node akan langsung dijalankan.

    2021-01-14T09:00:00Z
    PlannedEndTime

    string

    No

    Pengatur waktu paling akhir untuk mulai menjalankan Tugas terjadwal. Tentukan pengatur waktu dalam format YYYY-MM-DDThh:mm:ssZ (UTC).

    Catatan

    • Pengatur waktu paling akhir harus setidaknya 30 menit setelah Waktu mulai.

    • Jika Anda menentukan PlannedStartTime tetapi membiarkan parameter ini kosong, pengatur waktu paling akhir akan default ke Waktu mulai + 30 menit. Misalnya, jika Anda mengatur PlannedStartTime ke 2021-01-14T09:00:00Z dan membiarkan parameter ini kosong, tugas akan dimulai paling lambat 2021-01-14T09:30:00Z.

    2021-01-14T09:30:00Z
    DBNode

    array<object>

    Yes

    Informasi mengenai node baru.

    object

    No

    TargetClass

    string

    No

    Spesifikasi node baru. Spesifikasi harus sama dengan spesifikasi node yang ada. Untuk informasi lebih lanjut, lihat topik berikut:

    Catatan

    • Anda harus menentukan setidaknya satu dari DBNode.N.ZoneId dan DBNode.N.TargetClass. N adalah bilangan bulat yang dimulai dari 1. Nilai maksimum N = 16 - jumlah node saat ini.

    • Hanya kluster PolarDB Basis Data Relasional Cloud-Native for MySQL yang mendukung penambahan beberapa node read-only sekaligus. Anda dapat menambahkan hingga 15 node read-only.

    • 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.

    polar.mysql.x4.medium
    ZoneId

    string

    No

    Zona node baru. Zona harus sama dengan zona node yang ada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona.

    Catatan

    • Anda harus menentukan setidaknya satu dari DBNode.N.ZoneId dan DBNode.N.TargetClass. N adalah bilangan bulat yang dimulai dari 1. Nilai maksimum N = 16 - jumlah node saat ini.

    • Hanya kluster PolarDB Basis Data Relasional Cloud-Native for MySQL yang mendukung penambahan beberapa node read-only sekaligus. Anda dapat menambahkan hingga 15 node read-only.

    • 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.

    cn-qingdao-c
    DBNodeType

    string

    No

    Tipe node. Nilai valid:

    • RO

    • STANDBY

    • DLNode.

    Valid values:

    • DLNode :

      Node AI.

    • STANDBY :

      Node standby.

    • RO :

      Node read-only.

    RO
    ImciSwitch

    string

    No

    Apakah akan mengaktifkan In-Memory Column Index (Indeks Kolom IMCI). Nilai valid:

    • ON: Diaktifkan.

    • OFF: Dinonaktifkan. Ini adalah nilai default.

    Catatan

    PolarDB Basis Data Relasional Cloud-Native for PostgreSQL (Compatible with Oracle) dan PolarDB Basis Data Relasional Cloud-Native for PostgreSQL tidak mendukung parameter ini.

    ON
    CloudProvider

    string

    No

    Penyedia layanan cloud tempat node berada.

    ENS
    AutoUseCoupon

    boolean

    No

    Apakah akan menggunakan kupon secara otomatis. Nilai valid:

    • true (default): Menggunakan kupon.

    • false: Tidak menggunakan kupon.

    PromotionCode

    string

    No

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

    727xxxxxx934

    Elemen respons

    Element

    Type

    Description

    Example

    object

    DBNodeIds

    object

    DBNodeId

    array

    Daftar DBNodeIds yang dibuat.

    string

    Daftar DBNodeIds yang dibuat.

    pi-***************
    RequestId

    string

    ID permintaan.

    E053E730-5755-4AA9-AA9D-A47867******
    DBClusterId

    string

    ID kluster.

    pc-***************
    OrderId

    string

    ID pesanan.

    2148126708*****

    Contoh

    Respons sukses

    JSONformat

    {
  "DBNodeIds": {
    "DBNodeId": [
      "pi-***************"
    ]
  },
  "RequestId": "E053E730-5755-4AA9-AA9D-A47867******",
  "DBClusterId": "pc-***************",
  "OrderId": "2148126708*****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 ORDER.ARREARAGE 您有欠费账单，不符合购买条件，请先结清账单后再购买
    400 InvalidDBNodeNum.Malformed The number of parameter DBNode.N is not valid.
    400 InvalidDBNode.Malformed The specified parameter DBNode.N is not valid.
    400 OperationDenied.CreateDBNodesWithStrictConsistencyOn 3AZ cluster does not allow create db nodes.
    400 InvalidZoneId.Malformed The specified parameter ZoneId is not valid.
    403 OperationDenied.ClusterCategory The operation is not permitted due to cluster category.
    403 OperationDenied.DbVersion The operation is not permitted due to DbVersion.
    404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records.
    404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.