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

Mengubah spesifikasi instans ApsaraDB for Tair (kompatibel dengan Redis).

Deskripsi operasi

Catatan

Untuk informasi tentang proses eksekusi, dampak, batasan fitur, dan penagihan perubahan spesifikasi instans, lihat Mengubah 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 region. Anda dapat memanggil operasi DescribeRegions untuk meng-query ID region. Gunakan parameter ini untuk menentukan region tempat instans akan diubah.	cn-hangzhou
InstanceId	string	Yes	ID instans. Anda dapat memanggil operasi DescribeInstances untuk meng-query ID instans.	r-bp1zxszhcgatnx****
InstanceClass	string	No	Kode tipe instans baru. Anda dapat memanggil operasi DescribeAvailableResource untuk meng-query tipe instans yang tersedia di zona tempat instans berada untuk perubahan tersebut. Catatan Untuk detail tentang setiap tipe instans, lihat Query spesifikasi.	redis.master.small.default
BusinessInfo	string	No	ID 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 mengubah konfigurasi secara paksa. Nilai yang valid: false: tidak mengubah konfigurasi secara paksa. true: mengubah konfigurasi secara paksa. Ini adalah nilai default.	true
EffectiveTime	string	No	Waktu ketika perubahan berlaku. Nilai yang valid: Immediately: Perubahan berlaku segera. Ini adalah nilai default. MaintainTime: Perubahan berlaku selama jendela pemeliharaan instans. Anda dapat memanggil operasi ModifyInstanceMaintainTime untuk mengubah jendela pemeliharaan.	Immediately
AutoPay	boolean	No	Menentukan apakah akan mengaktifkan pembayaran otomatis. Nilai yang valid: true: mengaktifkan pembayaran otomatis. Ini adalah nilai default. false: menonaktifkan pembayaran otomatis. Jika pembayaran otomatis dinonaktifkan, Anda harus memperpanjang instans secara manual di konsol sebelum kedaluwarsa. Untuk informasi lebih lanjut, lihat Memperpanjang instans secara manual.	true
OrderType	string	No	Tipe perubahan. Parameter ini wajib diisi ketika Anda mengubah konfigurasi instans berlangganan. Nilai yang valid: UPGRADE: meningkatkan konfigurasi. Ini adalah nilai default. DOWNGRADE: menurunkan konfigurasi. Catatan Saat Anda menurunkan konfigurasi instans berlangganan, Anda harus menetapkan parameter ini ke DOWNGRADE. Jika harga tipe instans target lebih tinggi daripada tipe instans saat ini, perubahan tersebut dianggap sebagai peningkatan (upgrade). Jika tidak, dianggap sebagai penurunan (downgrade). Misalnya, harga edisi pemisahan baca/tulis 8 GB (dengan 5 replika baca) lebih tinggi daripada harga edisi cluster 16 GB. Oleh karena itu, perubahan dari edisi cluster ke edisi pemisahan baca/tulis dianggap sebagai peningkatan. Valid values: DOWNGRADE : DOWNGRADE UPGRADE : UPGRADE	DOWNGRADE
MajorVersion	string	No	Versi mayor tempat instans Classic ditingkatkan. Nilai yang valid: 2.8, 4.0, dan 5.0. Catatan Saat Anda meningkatkan versi mayor, parameter InstanceClass wajib diisi. Hal ini menunjukkan bahwa operasi ini hanya mendukung peningkatan versi mayor saat tipe instans diubah. Jika Anda hanya perlu meningkatkan versi mayor, panggil operasi ModifyInstanceMajorVersion.	5.0
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Klien menghasilkan nilai tersebut, yang harus unik di antara permintaan yang berbeda. Token dapat memiliki panjang hingga 64 karakter ASCII dan tidak boleh berisi karakter non-ASCII.	ETnLKlblzczshOTUbOCz****
SourceBiz	string	No	Sumber pemanggilan. Parameter ini hanya digunakan untuk pemeliharaan internal dan tidak perlu ditentukan.	SDK
ShardCount	integer	No	Jumlah shard. Parameter ini hanya didukung untuk instans cluster cloud-native. Anda dapat menggunakan parameter ini untuk menyesuaikan jumlah shard. Catatan Untuk mengubah instans cluster cloud-native menjadi instans standar, Anda harus secara eksplisit menetapkan ShardCount ke 1 dan menentukan tipe instans standar. Untuk mengubah instans standar cloud-native menjadi instans cluster, Anda harus secara eksplisit menetapkan ShardCount ke nilai yang lebih besar dari 1 dan menentukan tipe instans cluster.	8
ReplicaCount	integer	No	Jumlah node replika di zona utama. Parameter ini hanya didukung untuk instans cluster cloud-native dengan beberapa replika. Anda dapat menggunakan parameter ini untuk menyesuaikan jumlah node replika. Nilai yang valid: 1 hingga 4. Catatan Jika instans tersebut merupakan instans multi-zona, Anda dapat menggunakan parameter ini bersama dengan parameter SlaveReplicaCount untuk menyesuaikan jumlah node replika di zona utama dan sekunder. Jumlah parameter ini dan parameter SlaveReplicaCount tidak boleh melebihi 4.	1
SlaveReplicaCount	integer	No	Jumlah node replika di zona sekunder.	1
ReadOnlyCount	integer	No	Jumlah replika baca di zona utama. Parameter ini hanya didukung saat Anda membuat instans pemisahan baca/tulis cloud-native. Untuk instans standar, nilai yang valid adalah 0 hingga 9. Nilai 0 menunjukkan bahwa pemisahan baca/tulis dinonaktifkan dan instans dialihkan ke instans standar. Untuk instans cluster, nilai yang valid adalah 1 hingga 4, yang menunjukkan jumlah replika baca per shard data. Catatan Jika Anda membuat instans multi-zona, Anda dapat menggunakan parameter ini bersama dengan parameter SlaveReadOnlyCount untuk menyesuaikan jumlah replika baca di zona utama dan sekunder. Untuk instans standar, jumlah parameter ini dan SlaveReadOnlyCount tidak boleh lebih besar dari 9. Untuk instans cluster, jumlah parameter ini dan SlaveReadOnlyCount tidak boleh lebih besar dari 4.	5
SlaveReadOnlyCount	integer	No	Jumlah replika baca di zona sekunder.	2
ForceTrans	boolean	No	Menentukan apakah akan mengaktifkan transfer paksa. Nilai yang valid: false (default): Sebelum perubahan, sistem memeriksa versi minor instans saat ini. Jika versi minor terlalu rendah, error akan dikembalikan. Anda harus meningkatkan versi minor lalu coba lagi. true: melewati pemeriksaan dan langsung melakukan perubahan.	false
NodeType	string	No	Tipe node. Nilai yang valid: MASTER_SLAVE: ketersediaan tinggi (dual-replika) STAND_ALONE: replika tunggal double: dual-replika single: replika tunggal Catatan Untuk instans cloud-native, pilih MASTER_SLAVE atau STAND_ALONE. Untuk instans Classic, pilih double atau single.	MASTER_SLAVE
StorageType	string	No	Tipe penyimpanan. Nilai yang valid: essd_pl1, essd_pl2, dan essd_pl3. Catatan Parameter ini hanya wajib diisi ketika InstanceType ditetapkan ke tair_essd dan instans tersebut adalah instans berbasis Tair ESSD.	essd_pl1
Storage	integer	No	Kapasitas penyimpanan instans berbasis disk. Nilai yang valid bervariasi tergantung tipe instans. Untuk informasi lebih lanjut, lihat Tipe instans berbasis disk. Catatan Parameter ini hanya wajib diisi ketika InstanceType ditetapkan ke tair_essd dan Anda membuat instans berbasis Tair ESSD. Untuk instans berbasis Tair SSD, kapasitas didefinisikan sebagai nilai tetap untuk setiap tipe instans, dan Anda tidak perlu menentukan parameter ini.	60

Elemen respons

Element	Type	Description	Example
	object	Skema 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.