All Products
Search

This Product

    VPN Gateway:ModifyVpnRouteEntryWeight

    Document Center

    VPN Gateway:ModifyVpnRouteEntryWeight

    Last Updated:Oct 09, 2026

    Mengubah bobot entri rute tujuan.

    Deskripsi operasi

    Catatan

    Operasi ini hanya berlaku untuk instans Gateway VPN yang mendukung koneksi IPsec-VPN saluran data tunggal. Untuk instans Gateway VPN yang mendukung koneksi IPsec-VPN saluran data ganda, bobot yang dimodifikasi tidak akan berlaku meskipun operasi berhasil.

    • Jika terdapat entri rute tujuan aktif/standby di bawah instans Gateway VPN dan Anda ingin mengubah entri rute tujuan aktif, Anda harus menghapus entri rute tujuan standby terlebih dahulu. Setelah entri rute tujuan aktif dimodifikasi, konfigurasikan ulang entri rute tujuan standby. Jika Anda ingin mengubah entri rute tujuan standby, Anda harus menghapus entri rute tujuan aktif terlebih dahulu. Setelah entri rute tujuan standby dimodifikasi, konfigurasikan ulang entri rute tujuan aktif. Untuk menghapus entri rute tujuan, lihat DeleteVpnRouteEntry.

    • Operasi ModifyVpnRouteEntryWeight bersifat asinkron. Sistem mengembalikan ID permintaan, tetapi entri rute tujuan VPN tidak langsung dimodifikasi dan tugas modifikasi masih berjalan di latar belakang. Anda dapat memanggil operasi DescribeVpnGateway untuk mengkueri status modifikasi entri rute tujuan VPN:

      • Jika entri rute tujuan VPN berada dalam status updating, entri rute tujuan VPN sedang dimodifikasi.

      • Jika entri rute tujuan VPN berada dalam status active, entri rute tujuan VPN telah dimodifikasi.

    • Operasi ModifyVpnRouteEntryWeight tidak mendukung modifikasi konkuren entri rute tujuan di bawah Gateway VPN yang sama.

    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

    vpc:ModifyVpnRouteEntryWeight

    update

    *VpnGateway.

    acs:vpc:{#regionId}:{#accountId}:vpngateway/{#VpnGatewayId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah instans Gateway VPN. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilai ini, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Token klien hanya dapat berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dari setiap permintaan API bersifat unik.

    d7d24a21-f4ba-4454-9173-b3828dae492b
    VpnGatewayId

    string

    Yes

    ID Gateway VPN.

    vpn-bp1a3kqjiiq9legfx****
    RouteDest

    string

    Yes

    Blok CIDR tujuan entri rute tujuan.

    10.0.0.0/24
    NextHop

    string

    Yes

    Lompatan berikutnya entri rute tujuan.

    vco-bp15oes1py4i66rmd****

    Weight

    integer

    Yes

    Bobot entri rute tujuan sebelum modifikasi. Nilai valid:

    • 0: prioritas rendah.

    • 100: prioritas tinggi.

    0
    NewWeight

    integer

    Yes

    Bobot baru entri rute tujuan. Nilai valid:

    • 0: prioritas rendah.

    • 100: prioritas tinggi.

    100
    OverlayMode

    string

    No

    Protokol saluran data. Tetapkan nilai ke Ipsec (protokol Terowongan IPsec).

    Ipsec

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    5BE01CD7-5A50-472D-AC14-CA181C5C03BE

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "5BE01CD7-5A50-472D-AC14-CA181C5C03BE\t"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Resource.QuotaFull The quota of resource is full
    400 VpnGateway.Configuring The specified service is configuring.
    400 VpnGateway.FinancialLocked The specified service is financial locked.
    400 VpnRouteEntry.AlreadyExists The specified route entry is already exist. Entri rute sudah ada.
    400 VpnRouteEntry.Conflict The specified route entry has conflict. Terdapat konflik entri rute.
    400 VpnRouteEntry.BackupRoute Validate backup route entry failed. Validasi entri rute aktif/standby gagal. Konfigurasi perutean tidak valid.
    403 Forbbiden.SubUser User not authorized to operate on the specified resource as your account is created by another user.
    403 Forbidden User not authorized to operate on the specified resource. Anda tidak memiliki izin untuk melakukan operasi pada sumber daya yang ditentukan. Ajukan izin yang diperlukan dan coba lagi.
    404 InvalidVpnGatewayInstanceId.NotFound The specified vpn gateway instance id does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.