All Products
Search

This Product

    PolarDB:ModifyDBCluster

    Document Center

    PolarDB:ModifyDBCluster

    Last Updated:Jun 10, 2026

    Mengubah konfigurasi fitur kluster PolarDB Basis Data Relasional Cloud-Native MySQL.

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

    update

    *DBCluster

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DBClusterId

    string

    Yes

    ID kluster.

    Catatan

    Anda dapat memanggil operasi DescribeDBClusters untuk mengkueri detail semua kluster di wilayah tertentu, termasuk ID kluster mereka.

    pc-*************
    StandbyHAMode

    string

    No

    Mode failover lintas zona otomatis untuk kluster. Nilai valid:

    • ON: mengaktifkan failover lintas zona otomatis.

    • OFF: menonaktifkan failover lintas zona otomatis.

    ON
    DataSyncMode

    string

    No

    Metode replikasi data lintas zona untuk kluster. Nilai valid:

    • AsyncSync: asinkron.

    • SemiSync: semi-sinkron.

    AsynSync
    FaultSimulateMode

    string

    No

    Cakupan simulasi kesalahan untuk kluster. Nilai valid:

    • 0 atau FaultInjection: simulasi kesalahan tingkat zona utama.

    • 1: simulasi kesalahan tingkat node.

    Catatan

    • Dalam simulasi kesalahan tingkat zona utama, semua node komputasi di zona utama menjadi tidak tersedia. Failover pemulihan bencana dalam skenario ini bersifat lossy.

    • Dalam simulasi kesalahan tingkat node, Anda hanya dapat mensimulasikan kesalahan pada node tunggal komputasi saja. Anda harus menentukan node komputasi target dengan menggunakan parameter DBNodeCrashList.

    0
    StorageAutoScale

    string

    No

    Mengaktifkan atau menonaktifkan penskalaan penyimpanan otomatis untuk kluster standar. Nilai valid:

    • Enable: mengaktifkan penskalaan penyimpanan otomatis.

    • Disable: menonaktifkan penskalaan penyimpanan otomatis.

    Enable
    CompressStorage

    string

    No

    Mengaktifkan kompresi penyimpanan. Tetapkan nilai menjadi ON.

    ON
    StorageUpperBound

    integer

    No

    Batas atas untuk penskalaan penyimpanan otomatis pada kluster standar. Unit: GB.

    Catatan

    Nilai maksimum adalah 32000.

    800
    DBNodeCrashList

    string

    No

    Nama node yang akan ditargetkan dalam simulasi kesalahan.

    Catatan

    Untuk simulasi tingkat node, Anda hanya dapat menentukan node tunggal. Untuk simulasi tingkat zona, Anda dapat mengosongkan parameter ini atau menentukan semua node.

    pi-rwxxx
    FaultInjectionType

    string

    No

    Metode injeksi kesalahan. Nilai valid:

    • 0: injeksi kesalahan tingkat instans berdasarkan Crash SQL.

    Valid values:

    • CrashSQLInjection :

    0
    ImciAutoIndex

    string

    No

    Mengontrol fitur indeks kolumnar otomatis. Nilai valid:

    • ON: mengaktifkan fitur.

    • OFF: menonaktifkan fitur.

    Catatan

    Valid values:

    • OFF :
    • ON :

    OFF
    TableMeta

    string

    No

    String JSON yang menentukan informasi tentang database dan tabel tujuan yang akan dipulihkan. Semua nilai dalam informasi database dan tabel harus berupa string. Contoh: [ { "tables":[ { "name":"testtb", "type":"table", "newname":"testtb_restore" } ], "name":"testdb", "type":"db", "newname":"testdb_restore" } ].

    Catatan

    Anda dapat memanggil operasi DescribeMetaList untuk mengkueri database dan tabel yang dapat dipulihkan. Gunakan informasi yang dikembalikan untuk mengisi field di contoh JSON.

    [ { "tables":[ { "name":"testtb", "type":"table", "newname":"testtb_restore" } ], "name":"testdb", "type":"db", "newname":"testdb_restore" } ]
    ModifyRowCompression

    string

    No

    Mengaktifkan atau menonaktifkan kompresi tingkat baris.

    OFF

    Parameter berikut bersifat saling eksklusif dan tidak dapat digabungkan dengan parameter lain di satu permintaan: StandbyHAMode, DataSyncMode, FaultSimulateMode, atau StorageAutoScale.

    Catatan

    Jika Anda menetapkan StorageAutoScale menjadi Enable, Anda juga harus menentukan parameter StorageUpperBound.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The response schema.

    RequestId

    string

    The ID of the request.

    CD3FA5F3-FAF3-44CA-AFFF-BAF869******
    DBClusterId

    string

    The ID of the cluster.

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

    string

    The generated order ID.

    2148126708*****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "CD3FA5F3-FAF3-44CA-AFFF-BAF869******",
  "DBClusterId": "pc-*************",
  "OrderId": "2148126708*****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 OperationDenied.CreateDBNodesWithStrictConsistencyOn 3AZ cluster does not allow create db nodes.
    400 InvalidDBProxyClusterClass.Malformed The specified parameter DBProxyClusterClass is not valid.
    400 InvalidDBNodeNum.Malformed The number of parameter DBNode.N is not valid.
    400 OperationDenied.ModifyDBNodeClassWithStrictConsistencyOn 3AZ cluster does not allow modify db node class.
    400 InvalidDowngradeDBNodeClass.Limit The specified Downgrade DBNodeClass is limit on the MaxDiskSize.
    400 InvalidEngine.Unsupported The specified Engine does not support this feature.
    400 OperationDenied.ModifyProxyWithStrictConsistencyOn 3AZ cluster does not allow modify proxy.
    400 StandbyClusterTurnOn The specified dbCluster already turn on hot standby cluster.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    403 IncorrectDBInstanceType Current DB instance type does not support this operation.
    403 IncorrectDBInstance Current DB instance does not support this operation.
    403 OperationDenied.LockMode The operation is not permitted due to lock of cluster.
    403 OperationDenied.DBClusterStatus The operation is not permitted due to status of cluster.
    403 OperationDenied.TempUpgradeDuring This operation is not allowed during the temporary upgrade of the cluster.
    403 InvalidParam.PgDBNodeSpec The specification PGO of DB nodes is incorrect.
    403 InvalidParam.NoChange No change found
    403 OperationDenied.DBNodeClass The target DB node class is invalid for SQL acceleration.
    403 OperationDenied.ReaderNum The target reader node number is invalid for SQL acceleration.
    403 InvalidParam.DBNodeNum The number of DB nodes is incorrect.
    403 OperationDenied.DBNodeRole The operation is not permitted due to the role of node.
    403 OperationDenied.DeleteNode The senormal version cluster does not allow the deletion of ro nodes and standby nodes at the same time.
    403 OperationDenied.EndpointDBNodeNumber The operation is not permitted due to node number for Endpoint.
    403 OperationDenied.StandbyEqualSpec The spec of standby must be equal to rw
    403 OperationDenied.DeleteDBNodeNumber The operation is not permitted due to the node number to delete.
    403 OperationDenied.DbVersion The operation is not permitted due to DbVersion.
    403 OperationDenied.ClusterCategory The operation is not permitted due to cluster category.
    403 OperationDenied.clusterSingleNodeLimit Single-node instances are not supported and need to be upgraded to cluster version
    403 InvalidParam.CRACParamNodeNum The CRAC nodes cannot exceed 8.
    403 InvalidParam.ECSESSDSTANDARDParamNodeNum The ECSESSDSTANDARD nodes cannot exceed 8.
    404 InvalidParam Invalid Parameter.
    404 InvalidEditType Wrong upgrade type.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.