All Products
Search
Document Center

Tair (Redis® OSS-Compatible):EnableAdditionalBandwidth

Last Updated:Sep 16, 2026

Menyesuaikan bandwidth instans Tair (Redis® OSS-Compatible). 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 memanggil operasi ini saat fitur penyesuaian bandwidth otomatis diaktifkan untuk instans, instans akan mengutamakan penggunaan fitur penyesuaian bandwidth otomatis. Saat bandwidth diturunkan secara otomatis, bandwidth akan diturunkan ke bandwidth default spesifikasi instans. Untuk informasi lebih lanjut mengenai batas, penagihan, dan FAQ fitur ini, lihat Modify instance bandwidth.

Catatan

Sebelum memanggil operasi ini, Anda dapat memanggil 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

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

ID instans. Anda dapat memanggil 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 akun Anda memiliki saldo yang cukup.

  • false: Pembayaran otomatis dinonaktifkan. Anda harus menyelesaikan pembayaran secara manual.

true

NodeId

string

No

ID shard data. Anda dapat memanggil DescribeLogicInstanceTopology untuk mengkueri ID shard data. Pisahkan beberapa ID dengan koma (,). Anda juga dapat mengatur parameter ini ke All untuk menentukan semua shard data.

Catatan

Parameter ini tersedia dan wajib hanya ketika instans menggunakan arsitektur kluster atau arsitektur pemisahan baca/tulis.

r-bp1zxszhcgatnx****-db-0

Bandwidth

string

No

Jumlah bandwidth yang akan ditingkatkan, dalam MB/s. Nilai harus berupa bilangan bulat yang lebih besar atau sama dengan 0. Nilai maksimum adalah enam kali bandwidth default instans atau satu shard, dengan batas atas 192 MB/s. Misalnya, jika bandwidth default instans adalah 10 MB/s, rentang valid adalah 0 hingga 60.

Catatan
  • Anda dapat memanggil DescribeRoleZoneInfo dan memeriksa parameter respons DefaultBandWidth untuk mendapatkan bandwidth maksimum default. Untuk informasi lebih lanjut mengenai spesifikasi instans, lihat Navigasi spesifikasi instans.

  • Jika Anda menentukan beberapa ID shard data untuk parameter permintaan NodeId, nilai bandwidth yang ditentukan untuk parameter ini harus sesuai dengan ID shard data secara berurutan. Pisahkan beberapa nilai bandwidth dengan koma (,).

20

OrderTimeLength

string

No

Durasi pembelian, dalam hari. Nilai valid: 1, 2, 3, 7, 14, 30, 60, 90, 180, 365, 730, 1095, dan 1825.

Catatan

Untuk terus menggunakan bandwidth yang dibeli, panggil RenewAdditionalBandwidth untuk perpanjangan bandwidth sebelum masa berlaku habis.

30

SourceBiz

string

No

Sumber permintaan. 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: Perpanjangan otomatis diaktifkan.

  • false (default): Perpanjangan otomatis dinonaktifkan.

false

AutoRenewPeriod

integer

No

Periode perpanjangan otomatis, dalam bulan. Nilai valid: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, dan 60.

Catatan
  • Parameter ini tersedia dan wajib hanya ketika parameter AutoRenew diatur ke true.

  • Setelah parameter ini diatur, Anda tidak dapat mengkueri nilai dengan memanggil operasi API. Di konsol, klik Expenses and Costs > Renewal Management dari bilah menu atas, lalu masukkan ID instans diikuti dengan akhiran -bw (misalnya, r-bp1zxszhcgatnx****-bw) di kotak teks Instance ID untuk mengkueri nilai.

1

ChargeType

string

No

Metode penagihan untuk bandwidth tambahan. Nilai valid:

  • PrePaid: langganan.

  • PostPaid: pay-as-you-go. Saat ini, hanya metode ini yang didukung.

PrePaid

BandWidthBurst

boolean

No

Apakah akan mengaktifkan bandwidth elastis burstable (level detik). Setelah penskalaan bandwidth elastis diaktifkan, bandwidth elastis burstable (level detik) tidak dapat diaktifkan, dan sebaliknya.

false

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.