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

Mengubah spesifikasi instans ApsaraDB for Tair (Redis® OSS-Compatible).

Deskripsi operasi

Catatan

Untuk informasi mengenai proses eksekusi, dampak, batasan fitur, dan penagihan terkait perubahan spesifikasi, 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 DescribeRegions untuk menanyakan wilayah yang tersedia. Gunakan parameter ini untuk menentukan wilayah instans yang ingin Anda ubah spesifikasinya.	cn-hangzhou
InstanceId	string	Yes	ID instans. Anda dapat memanggil DescribeInstances untuk menanyakan ID instans.	r-bp1zxszhcgatnx****
InstanceClass	string	No	Tipe instans baru. Anda dapat memanggil DescribeAvailableResource untuk menanyakan tipe instans yang tersedia untuk perubahan spesifikasi di zona tempat instans berada. Catatan Untuk informasi lebih lanjut mengenai tipe instans, lihat Navigasi tipe instans.	redis.master.small.default
BusinessInfo	string	No	ID aktivitas dan 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 spesifikasi. Nilai yang valid: false: tidak memaksa perubahan spesifikasi. true: memaksa perubahan spesifikasi. Ini adalah nilai default.	true
EffectiveTime	string	No	Waktu penerapan perubahan spesifikasi. Nilai yang valid: Immediately: Perubahan spesifikasi diterapkan segera. Ini adalah nilai default. MaintainTime: Perubahan spesifikasi diterapkan selama jendela pemeliharaan instans. Anda dapat memanggil ModifyInstanceMaintainTime untuk mengubah jendela pemeliharaan.	Immediately
AutoPay	boolean	No	Menentukan apakah akan mengaktifkan pembayaran otomatis. Nilai yang valid: true: Pembayaran otomatis diaktifkan. Ini adalah nilai default. false: Pembayaran otomatis dinonaktifkan. Jika Anda menetapkan parameter ini ke false, Anda harus memperpanjang instans secara manual sebelum instans kedaluwarsa di Konsol. Untuk detailnya, lihat Perpanjangan manual.	true
OrderType	string	No	Jenis perubahan spesifikasi. Parameter ini wajib ditentukan saat Anda mengubah spesifikasi instans subscription. Nilai yang valid: UPGRADE: Peningkatan. Ini adalah nilai default. DOWNGRADE: Menurunkan spesifikasi. Catatan Anda harus menetapkan parameter ini ke DOWNGRADE saat menurunkan spesifikasi instans subscription. Jika harga tipe instans target lebih tinggi daripada tipe instans saat ini, perubahan tersebut merupakan peningkatan. Sebaliknya, perubahan tersebut merupakan penurunan spesifikasi. Misalnya, harga edisi pemisahan baca/tulis 8 GB (5 node read-only) lebih tinggi daripada edisi kluster 16 GB. Mengubah dari yang terakhir ke yang pertama merupakan peningkatan. Valid values: DOWNGRADE : DOWNGRADE UPGRADE : UPGRADE	DOWNGRADE
MajorVersion	string	No	Versi mesin utama untuk meningkatkan instans classic. Nilai yang valid: 2.8, 4.0, dan 5.0. Catatan Saat Anda melakukan peningkatan versi, parameter InstanceClass wajib diisi. Hal ini menunjukkan bahwa operasi ini hanya mendukung peningkatan versi jika spesifikasi instans juga diubah. Untuk hanya meningkatkan versi instans, panggil 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 permintaan. Parameter ini hanya digunakan untuk maintenance internal dan tidak perlu ditentukan.	SDK
ShardCount	integer	No	Jumlah shard. Parameter ini hanya berlaku untuk instans kluster cloud-native. Anda dapat menggunakan parameter ini untuk menentukan jumlah shard kustom. Catatan Untuk mengubah instans kluster cloud-native menjadi arsitektur standar, atur ShardCount ke 1 dan atur tipe instans ke tipe instans standar. Untuk mengubah instans standar cloud-native menjadi arsitektur kluster, atur ShardCount ke nilai lebih dari 1 dan atur tipe instans ke tipe instans kluster.	8
ReplicaCount	integer	No	Jumlah node replika di zona primer. Parameter ini hanya berlaku untuk instans multi-replika kluster cloud-native. Anda dapat menggunakan parameter ini untuk menentukan jumlah node replika kustom. Nilai yang valid: 1 hingga 4. Catatan Untuk instans multi-zona, Anda dapat menggunakan parameter ini bersama dengan parameter SlaveReplicaCount untuk menentukan jumlah node replika di zona primer 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 node read-only di zona primer. Parameter ini hanya berlaku untuk instans pemisahan baca/tulis cloud-native. Untuk instans arsitektur standar, nilai yang valid adalah 0 hingga 9. Nilai 0 menunjukkan bahwa pemisahan baca/tulis dimatikan dan instans dialihkan ke arsitektur standar. Untuk instans arsitektur kluster, nilai yang valid adalah 1 hingga 4, yang menentukan jumlah node read-only per shard data. Catatan Untuk instans multi-zona, Anda dapat menggunakan parameter ini bersama dengan parameter SlaveReadOnlyCount untuk menentukan jumlah node read-only di zona primer dan sekunder. Untuk instans arsitektur standar, jumlah parameter ini dan SlaveReadOnlyCount tidak boleh melebihi 9. Untuk instans arsitektur kluster, jumlah parameter ini dan SlaveReadOnlyCount tidak boleh melebihi 4.	5
SlaveReadOnlyCount	integer	No	Jumlah node read-only di zona sekunder.	2
ForceTrans	boolean	No	Menentukan apakah akan mengaktifkan transmisi paksa. Nilai yang valid: false (default): Sebelum perubahan spesifikasi, sistem memeriksa versi minor mesin saat ini. Jika versi minor mesin terlalu lama, sistem akan mengembalikan error. Anda harus meningkatkan versi minor mesin dan mencoba lagi. true: Melewati pemeriksaan dan langsung menjalankan operasi perubahan spesifikasi.	false
NodeType	string	No	Tipe node. Nilai yang valid: MASTER_SLAVE: ketersediaan tinggi (dual-replika) STAND_ALONE: single replika double: dual-replika single: single replika 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 wajib diisi hanya jika InstanceType diatur ke tair_essd dan instans merupakan instans disk cloud berbasis Tair ESSD.	essd_pl1
Storage	integer	No	Kapasitas penyimpanan instans disk cloud. Nilai yang valid bervariasi berdasarkan tipe instans. Untuk informasi lebih lanjut, lihat Tipe instans berbasis disk cloud. Catatan Parameter ini wajib diisi hanya jika InstanceType diatur ke tair_essd dan Anda membuat instans disk cloud berbasis Tair ESSD. Untuk instans disk cloud berbasis Tair SSD, kapasitas penyimpanan merupakan nilai tetap berdasarkan tipe instans, sehingga Anda tidak perlu menentukan parameter ini.	60
SecondaryZoneId	string	No	ID zona sekunder. Parameter ini wajib diisi saat Anda mengubah spesifikasi instans single-zone dan memigrasikannya ke penerapan multi-zona. Anda dapat memanggil DescribeZones untuk menanyakan zona yang tersedia. Catatan Nilai parameter ini harus berbeda dari nilai parameter ZoneId. Jangan atur parameter ini ke ID multi-zona.	cn-hangzhou-h

Elemen respons

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