EnableAdditionalBandwidth - Tair (Redis® OSS-Compatible)

Menyesuaikan bandwidth instans Database Apsara for Tair (kompatibel dengan Redis). Saat ini, hanya metode penagihan pay-as-you-go yang didukung. Anda hanya perlu menentukan parameter InstanceId, NodeId (opsional), Bandwidth, dan ChargeType.

Deskripsi operasi

Jika Anda mengaktifkan fitur skalabilitas elastis bandwidth saat memanggil operasi ini, instans akan mengutamakan penggunaan fitur skalabilitas elastis bandwidth. Saat bandwidth diskalakan masuk secara elastis, bandwidth akan diskalakan masuk ke bandwidth default spesifikasi instans. Untuk informasi lebih lanjut mengenai batas, biaya, dan FAQ fitur ini, lihat Menyesuaikan Bandwidth Instans.

Catatan

Sebelum memanggil operasi ini, Anda dapat memanggil operasi DescribeRoleZoneInfo untuk mengkueri bandwidth saat ini dari setiap node data di 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:EnableAdditionalBandwidth

update

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans. Anda dapat memanggil operasi DescribeInstances untuk mengkueri ID instans.	r-bp1zxszhcgatnx****
CouponNo	string	No	Kode kupon.	youhuiquan_promotion_option_id_for_blank
AutoPay	boolean	No	Apakah akan mengaktifkan pembayaran otomatis. Nilai valid: true (default): Pembayaran otomatis diaktifkan. Pastikan saldo akun Anda mencukupi. false: Pembayaran manual diperlukan.	true
NodeId	string	No	ID shard data. Anda dapat memanggil operasi DescribeLogicInstanceTopology untuk mengkueri ID shard data. Pisahkan beberapa ID dengan koma (,). Anda juga dapat menentukan All untuk menunjukkan semua shard data. Catatan Parameter ini tersedia dan diperlukan hanya ketika instans menggunakan arsitektur kluster atau arsitektur pemisahan baca/tulis.	r-bp1zxszhcgatnx****-db-0
Bandwidth	string	No	Bandwidth yang ingin Anda tambahkan. Unit: MB/s. Nilai harus berupa bilangan bulat yang lebih besar atau sama dengan 0. Nilai maksimum dapat enam kali lipat bandwidth default spesifikasi instans (atau satu shard data), tetapi batas atas penambahannya adalah 192 MB/s. Misalnya, jika bandwidth default instans adalah 10 MB/s, rentang nilai penambahannya adalah dari 0 hingga 60. Catatan Anda dapat memanggil operasi DescribeRoleZoneInfo dan mendapatkan bandwidth maksimum default dari parameter respons DefaultBandWidth. Untuk informasi lebih lanjut mengenai spesifikasi instans, lihat Navigasi Kueri Spesifikasi Instans. Jika Anda menentukan beberapa ID shard data untuk parameter permintaan NodeId, nilai bandwidth yang ditentukan untuk parameter ini harus sesuai dengan urutan ID shard data. Pisahkan beberapa nilai bandwidth dengan koma (,).	20
OrderTimeLength	string	No	Durasi langganan. Unit: hari. Nilai valid: 1, 2, 3, 7, 14, 30, 60, 90, 180, 365, 730, 1095, dan 1825. Catatan Jika Anda ingin terus menggunakan bandwidth yang dibeli, Anda harus memanggil operasi RenewAdditionalBandwidth untuk perpanjangan bandwidth sebelum masa berlakunya habis.	30
SourceBiz	string	No	Sumber panggilan. Parameter ini hanya digunakan untuk pemeliharaan internal. Anda tidak perlu menentukan parameter ini.	SDK
AutoRenew	boolean	No	Apakah akan mengaktifkan perpanjangan otomatis. Nilai valid: true: Mengaktifkan perpanjangan otomatis. false: Menonaktifkan perpanjangan otomatis. Ini adalah nilai default.	false
AutoRenewPeriod	integer	No	Siklus perpanjangan otomatis. Unit: bulan. Nilai valid: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, dan 60. Catatan Parameter ini tersedia dan diperlukan hanya ketika parameter AutoRenew diatur ke true. Setelah parameter ini diatur, parameter ini tidak dapat dikueri menggunakan API. Anda dapat mengklik Expenses > Renewal Management di bilah navigasi atas Konsol, lalu memasukkan ID instans dengan akhiran `-bw` (seperti r-bp1zxszhcgatnx**-bw) di kotak teks Instance ID** untuk mengkueri informasi perpanjangan.	1
ChargeType	string	No	Metode penagihan bandwidth tambahan. Nilai valid: PrePaid: langganan. PostPaid: pay-as-you-go. Hanya metode penagihan ini yang didukung.	PrePaid
BandWidthBurst	boolean	No

Elemen respons

Element	Type	Description	Example
	object
OrderId	string	ID pesanan.	2084452111111
RequestId	string	ID permintaan.	D622714-AEDD-4609-9167-F5DDD3D1****

Contoh

Respons sukses

JSONformat

{
  "OrderId": "2084452111111",
  "RequestId": "D622714-AEDD-4609-9167-F5DDD3D1****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.