ModifyInstanceSpec - Tair (Redis® OSS-Compatible) - Alibaba Cloud Documentation Center

Mengubah konfigurasi instans Tair (kompatibel dengan Redis OSS).

Deskripsi operasi

Catatan

Untuk informasi lebih lanjut mengenai prosedur, dampak, batasan, dan biaya operasi ini, lihat Ubah konfigurasi instans.

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

kvstore:ModifyInstanceSpec

update

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.	cn-hangzhou
InstanceId	string	Yes	ID instans. Anda dapat memanggil operasi DescribeInstances untuk mengambil ID instans.	r-bp1zxszhcgatnx****
InstanceClass	string	No	Tipe instans baru. Anda dapat memanggil operasi DescribeAvailableResource untuk mengambil daftar tipe instans yang tersedia untuk perubahan konfigurasi dalam zona tempat instans berada. Catatan Untuk informasi selengkapnya mengenai tipe instans, lihat Ikhtisar.	redis.master.small.default
BusinessInfo	string	No	ID event promosi atau informasi bisnis.	000000001
CouponNo	string	No	Kode kupon. Nilai default: `youhuiquan_promotion_option_id_for_blank`.	youhuiquan_promotion_option_id_for_blank
ForceUpgrade	boolean	No	Menentukan apakah akan memaksa perubahan konfigurasi. Nilai yang valid: false: Sistem tidak memaksa perubahan konfigurasi. true (default): Sistem memaksa perubahan konfigurasi.	true
EffectiveTime	string	No	Waktu saat Anda ingin konfigurasi diubah. Nilai yang valid: Immediately (default): segera mengubah konfigurasi. MaintainTime: mengubah konfigurasi dalam jendela pemeliharaan. Anda dapat memanggil operasi ModifyInstanceMaintainTime untuk mengubah jendela pemeliharaan.	Immediately
AutoPay	boolean	No	Menentukan apakah akan mengaktifkan pembayaran otomatis. Nilai yang valid: true (default): mengaktifkan pembayaran otomatis. false: menonaktifkan pembayaran otomatis. Jika Anda mengatur parameter ini ke false, instans harus diperpanjang secara manual sebelum masa berlakunya habis. Untuk informasi selengkapnya, lihat Perpanjang instans.	true
OrderType	string	No	Jenis perubahan. Parameter ini wajib ditentukan saat Anda mengubah konfigurasi instans langganan. Nilai yang valid: UPGRADE (default): meningkatkan konfigurasi instans langganan. DOWNGRADE: menurunkan spesifikasi instans langganan. Catatan Untuk menurunkan spesifikasi instans langganan, Anda harus mengatur parameter ini ke DOWNGRADE. Jika harga instans meningkat setelah konfigurasinya diubah, maka instans tersebut ditingkatkan. Jika harganya menurun, maka instans tersebut diturunkan spesifikasinya. Misalnya, harga instans 8 GB dengan arsitektur pemisahan baca/tulis dan lima replika baca lebih tinggi daripada instans kluster 16 GB. Jika Anda ingin mengubah instans kluster 16 GB menjadi instans 8 GB dengan arsitektur pemisahan baca/tulis dan lima replika baca, Anda harus melakukan upgrade instans. Valid values: DOWNGRADE : DOWNGRADE UPGRADE : UPGRADE	DOWNGRADE
MajorVersion	string	No	Versi utama instans klasik yang ingin Anda tingkatkan. Nilai yang valid: 2.8, 4.0, dan 5.0. Catatan Parameter InstanceClass wajib ditentukan saat Anda meningkatkan versi instans. Hal ini menunjukkan bahwa Anda hanya dapat meningkatkan versi instans ketika memperbarui spesifikasi instans. Jika Anda hanya perlu meningkatkan versi instans, panggil operasi ModifyInstanceMajorVersion.	5.0
ClientToken	string	No	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.	ETnLKlblzczshOTUbOCz****
SourceBiz	string	No	Sumber operasi. Parameter ini hanya digunakan untuk maintenance internal. Anda tidak perlu menentukan parameter ini.	SDK
ShardCount	integer	No	Jumlah shard. Parameter ini hanya berlaku untuk instans kluster cloud-native. Catatan Jika Anda ingin mengubah instans kluster cloud-native menjadi instans standar, Anda harus secara eksplisit mengatur parameter ShardCount ke 1 dan menentukan spesifikasi instans master-replika. Untuk mengubah instans standar cloud-native menjadi instans kluster, Anda harus secara eksplisit mengatur parameter ShardCount ke nilai lebih dari 1 dan menentukan spesifikasi instans kluster.	8
ReplicaCount	integer	No	Jumlah node replika di zona primer. Parameter ini hanya berlaku untuk instans kluster multi-replika cloud-native. Nilai yang valid: 1 hingga 4. Catatan Jumlah nilai parameter ini dan parameter SlaveReplicaCount tidak boleh lebih dari 4. Anda dapat menentukan salah satu dari ReplicaCount atau ReadOnlyCount. Instans master-replika tidak dapat memiliki beberapa node replika.	1
SlaveReplicaCount	integer	No	Jumlah node replika di zona sekunder saat Anda membuat instans kluster multi-replika cloud-native yang dideploy di beberapa zona. Jumlah nilai parameter ini dan parameter ReplicaCount tidak boleh lebih dari 4. Catatan Saat Anda membuat instans kluster multi-replika cloud-native yang dideploy di beberapa zona, Anda harus menentukan SlaveReplicaCount dan SecondaryZoneId.	1
ReadOnlyCount	integer	No	Jumlah replika baca di zona primer. Nilai yang valid: 0 hingga 5. Parameter ini hanya berlaku untuk skenario berikut: Jika instans adalah instans standar cloud-native, Anda dapat mengatur parameter ini ke nilai lebih dari 0 untuk mengaktifkan arsitektur pemisahan baca/tulis. Jika instans adalah instans pemisahan baca/tulis cloud-native, Anda dapat menggunakan parameter ini untuk menyesuaikan jumlah replika baca. Anda juga dapat mengatur parameter ini ke 0 untuk menonaktifkan arsitektur pemisahan baca/tulis dan mengalihkan instans ke arsitektur standar.	5
SlaveReadOnlyCount	integer	No	Jumlah replika baca di zona sekunder saat Anda membuat instans pemisahan baca/tulis yang dideploy di beberapa zona. Nilai yang valid: 1 hingga 9. Jumlah nilai parameter ini dan parameter ReadOnlyCount tidak boleh lebih dari 9.	2
ForceTrans	boolean	No	Menentukan apakah akan mengaktifkan transmisi paksa selama perubahan konfigurasi. Nilai yang valid: false (default): Sebelum perubahan konfigurasi, sistem memeriksa versi minor instans. Jika versi minor instans sudah usang, sistem akan melaporkan error. Anda harus memperbarui versi minor instans dan mencoba lagi. true: Sistem melewati pemeriksaan versi dan langsung melakukan perubahan konfigurasi.	false
NodeType	string	No	Tipe node. Nilai yang valid: MASTER_SLAVE: ketersediaan tinggi (master-replika) STAND_ALONE: standalone double: master-replika single: standalone Catatan Untuk membuat instans cloud-native, atur parameter ini ke MASTER_SLAVE atau STAND_ALONE. Untuk membuat instans klasik, atur parameter ini ke double atau single.	MASTER_SLAVE
StorageType	string	No	Tipe penyimpanan. Nilai yang valid: essd_pl1, essd_pl2, dan essd_pl3. Catatan Parameter ini wajib ditentukan hanya jika Anda mengatur parameter InstanceType ke tair_essd untuk membuat instans berbasis ESSD.	essd_pl1
Storage	integer	No	Kapasitas penyimpanan instans berbasis ESSD/SSD. Nilai yang valid bervariasi tergantung pada tipe instans. Untuk informasi selengkapnya, lihat Instans berbasis ESSD/SSD. Catatan Parameter ini wajib ditentukan hanya jika Anda mengatur parameter InstanceType ke tair_essd untuk membuat instans berbasis ESSD. Jika Anda membuat instans Tair berbasis SSD, parameter Storage akan ditentukan secara otomatis berdasarkan spesifikasi yang telah ditetapkan. Anda tidak perlu menentukan parameter ini.	60

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
OrderId	string	ID pesanan.	20722623431****
RequestId	string	ID permintaan.	0DA1D7EF-C80D-432C-8758-7D225182626B

Contoh

Respons sukses

JSONformat

{
  "OrderId": "20722623431****",
  "RequestId": "0DA1D7EF-C80D-432C-8758-7D225182626B"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	PaymentMethodNotFound	No payment method has been registered on the account.
400	HasRenewChangeOrder	This instance has a renewChange order.
400	%s	Warn: {%s} are not supported after upgraded. you can set forceUpgrade=true to force upgrade.
400	GdcInstanceNotSupport	The gdc custins trans not support.
400	AbnormalResourceStatusForRenew	Abnormal resource status for renew.
400	MissingRedisShardingUnsupportPerfItem	The metadb is missing redis sharding unsupoort command perf item.
400	IllegalParamError	Action or resource must not be null.
400	IncorrectTargetMajorVersion	Current target majorversion does not support this operation.
400	IncorrectMinorVersion	Current engine minor version does not support operations.
400	DirectTargetLevelNotSupport	The direct custins tranfer target instance level does not support.
400	DirectTransPreCheckError	The direct custins trans pre check IsAddReduceNodes error.
400	DtsOpendNotSupportTrans	The custins DtsSyncStatus opend does not support trans.
400	DirectTransNodeDoubleLevelError	The direct custins tranfer node double target level error.
400	DirectTransUpgradeMajorVersionNotSupport	The direct custins tranfer does not support upgrade major version.
403	TargetMemoryLessThanCurrentUsed	The target instance memory size below the current instance used memory.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.