Ubah pengaturan kluster PolarDB MySQL melalui API - PolarDB - Alibaba Cloud - PolarDB

Mengubah konfigurasi fitur kluster PolarDB Basis Data Relasional Cloud-Native untuk 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

Parameter permintaan

Parameter	Type	Required	Description	Example
DBClusterId	string	Yes	ID kluster. Catatan Anda dapat memanggil operasi DescribeDBClusters untuk mengkueri informasi tentang semua kluster di wilayah tertentu, termasuk ID kluster.	pc-*************
StandbyHAMode	string	No	Mode Alih bencana otomatis lintas zona kluster. Nilai valid: ON: Mengaktifkan Alih bencana otomatis lintas zona. OFF: Menonaktifkan Alih bencana otomatis lintas zona.	ON
DataSyncMode	string	No	Mode replikasi data lintas zona kluster. Nilai valid: AsyncSync: Asinkron. SemiSync: Semi-sinkron.	AsynSync
FaultSimulateMode	string	No	Dimensi latihan pemulihan bencana untuk kluster. Nilai valid: `0` atau `FaultInjection`: Latihan pemulihan bencana tingkat zona utama. `1`: Latihan pemulihan bencana tingkat node. Catatan Dalam skenario latihan pemulihan bencana tingkat zona utama, semua node komputasi di zona utama menjadi tidak tersedia. Failover dalam skenario ini menyebabkan gangguan layanan. Dalam skenario latihan pemulihan bencana tingkat node, hanya satu node komputasi yang didukung untuk latihan. Tentukan nama node komputasi yang diinginkan dengan menggunakan `DBNodeCrashList`.	0
StorageAutoScale	string	No	Apakah akan mengaktifkan penskalaaan penyimpanan otomatis untuk kluster Jenis Penyimpanan Standar. Nilai valid: Enable: Mengaktifkan penskalaaan penyimpanan otomatis. Disable: Menonaktifkan penskalaaan penyimpanan otomatis. Valid values: Enable : Mengaktifkan penskalaaan penyimpanan otomatis. Disable : Menonaktifkan penskalaaan penyimpanan otomatis.	Enable
CompressStorage	string	No	Mengaktifkan kompresi penyimpanan. Atur nilai menjadi ON.	ON
StorageUpperBound	integer	No	Batas atas penskalaaan penyimpanan otomatis untuk kluster Jenis Penyimpanan Standar. Unit: GB. Catatan Nilai maksimum adalah 32000.	800
DBNodeCrashList	string	No	Daftar nama instans node untuk latihan. Catatan Latihan tingkat node hanya mendukung node tunggal. Untuk latihan tingkat zona, Anda dapat mengosongkan parameter ini atau menentukan semua node.	pi-rwxxx
FaultInjectionType	string	No	Metode injeksi kesalahan. Nilai valid: 0: Injeksi kesalahan instans berdasarkan `Crash SQL`. Valid values: CrashSQLInjection : CrashSQLInjection.	0
ImciAutoIndex	string	No	Fitur akselerasi kueri otomatis berbasis Indeks Kolom IMCI. Nilai valid: `ON`: Diaktifkan. `OFF`: Dinonaktifkan. Catatan Hanya kluster PolarDB Basis Data Relasional Cloud-Native untuk MySQL yang didukung. Untuk persyaratan versi kluster, lihat Akselerasi otomatis (AutoIndex). Valid values: OFF : OFF. ON : ON	OFF
TableMeta	string	No	String JSON yang berisi informasi tentang database dan tabel yang akan dipulihkan. Nilai informasi database dan tabel 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 nama database dan tabel yang dapat dipulihkan, lalu menentukan informasi pada posisi yang sesuai dalam contoh sebelumnya.	[ { "tables":[ { "name":"testtb", "type":"table", "newname":"testtb_restore" } ], "name":"testdb", "type":"db", "newname":"testdb_restore" } ]
ModifyRowCompression	string	No	Mengubah pengaturan kompresi baris.	OFF
ConnectionResourceQuota	integer	No	Kuota sumber daya koneksi kluster AgenticDB.

Anda hanya dapat mengatur satu dari parameter berikut per panggilan: StandbyHAMode, DataSyncMode, FaultSimulateMode, dan StorageAutoScale. Misalnya, jika Anda mengatur parameter StandbyHAMode, Anda tidak dapat mengatur parameter permintaan lain pada pengatur waktu yang sama.

Catatan

Setelah Anda mengatur parameter StorageAutoScale ke Enable, Anda juga harus mengatur parameter StorageUpperBound untuk menentukan batas atas penskalaaan penyimpanan otomatis untuk kluster.

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	CD3FA5F3-FAF3-44CA-AFFF-BAF869******
DBClusterId	string	ID kluster.	pc-*************
OrderId	string	ID pesanan.	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.	Penambahan node ke kluster tiga zona tidak diizinkan.
400	InvalidDBProxyClusterClass.Malformed	The specified parameter DBProxyClusterClass is not valid.	Parameter DBProxyClusterClass yang ditentukan tidak valid.
400	InvalidDBNodeNum.Malformed	The number of parameter DBNode.N is not valid.	Jumlah parameter DBNode tidak valid.
400	OperationDenied.ModifyDBNodeClassWithStrictConsistencyOn	3AZ cluster does not allow modify db node class.	Pengubahan spesifikasi node dari node logger di kluster tiga zona tidak diizinkan.
400	InvalidDowngradeDBNodeClass.Limit	The specified Downgrade DBNodeClass is limit on the MaxDiskSize.	Penurunan spesifikasi DBNodeClass dibatasi oleh MaxDiskSize.
400	InvalidEngine.Unsupported	The specified Engine does not support this feature.	Mesin yang ditentukan tidak mendukung fitur ini.
400	OperationDenied.ModifyProxyWithStrictConsistencyOn	3AZ cluster does not allow modify proxy.	Mengubah proksi database di kluster tiga zona tidak diizinkan.
400	StandbyClusterTurnOn	The specified dbCluster already turn on hot standby cluster.	Kluster hot standby sudah diaktifkan pada dbCluster yang ditentukan.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Pemrosesan permintaan gagal karena error, pengecualian, atau kegagalan yang tidak diketahui.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Tipe Instansiasi database saat ini tidak mendukung operasi ini.
403	IncorrectDBInstance	Current DB instance does not support this operation.	Instansiasi database saat ini tidak mendukung operasi ini.
403	OperationDenied.LockMode	The operation is not permitted due to lock of cluster.	Operasi gagal karena instans dalam status Terkunci dan tidak mendukung operasi ini.
403	OperationDenied.DBClusterStatus	The operation is not permitted due to status of cluster.	Operasi tidak diizinkan dalam status kluster PolarDB Basis Data Relasional Cloud-Native saat ini.
403	OperationDenied.TempUpgradeDuring	This operation is not allowed during the temporary upgrade of the cluster.	Operasi ini tidak diizinkan selama peningkatan sementara kluster.
403	InvalidParam.PgDBNodeSpec	The specification PGO of DB nodes is incorrect.	Spesifikasi PGO node DB tidak benar.
403	InvalidParam.NoChange	No change found	Tidak ada perubahan yang ditemukan.
403	OperationDenied.DBNodeClass	The target DB node class is invalid for SQL acceleration.	Kelas node DB target tidak valid untuk akselerasi SQL.
403	OperationDenied.ReaderNum	The target reader node number is invalid for SQL acceleration.	ID node pembaca target tidak valid untuk akselerasi SQL.
403	InvalidParam.DBNodeNum	The number of DB nodes is incorrect.	Jumlah node database tidak benar.
403	OperationDenied.DBNodeRole	The operation is not permitted due to the role of node.	Operasi tidak diizinkan karena peran node.
403	OperationDenied.DeleteNode	The senormal version cluster does not allow the deletion of ro nodes and standby nodes at the same time.	Kluster edisi SENormal tidak mengizinkan penghapusan node read-only dan node standby secara bersamaan.
403	OperationDenied.EndpointDBNodeNumber	The operation is not permitted due to node number for Endpoint.	Operasi tidak diizinkan untuk titik akhir ini.
403	OperationDenied.StandbyEqualSpec	The spec of standby must be equal to rw	Spesifikasi standby harus berupa RW.
403	OperationDenied.DeleteDBNodeNumber	The operation is not permitted due to the node number to delete.	Node tidak diizinkan untuk dihapus.
403	OperationDenied.DbVersion	The operation is not permitted due to DbVersion.	Operasi tidak diizinkan karena versi mesin database.
403	OperationDenied.ClusterCategory	The operation is not permitted due to cluster category.	Kluster tidak mendukung seri produk ini.
403	OperationDenied.clusterSingleNodeLimit	Single-node instances are not supported and need to be upgraded to cluster version	Instans node tunggal tidak didukung. Tingkatkan instans ke Edisi Kluster.
403	InvalidParam.CRACParamNodeNum	The CRAC nodes cannot exceed 8.	Jumlah node CRAC tidak boleh melebihi 8.
403	InvalidParam.ECSESSDSTANDARDParamNodeNum	The ECSESSDSTANDARD nodes cannot exceed 8.	Jumlah node ECESSDSTANDARD tidak boleh melebihi 8.
404	InvalidParam	Invalid Parameter.
404	InvalidEditType	Wrong upgrade type.	Tipe peningkatan tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.