All Products
Search

This Product

    VPN Gateway:ModifyVpnRouteEntryWeight

    Document Center

    VPN Gateway:ModifyVpnRouteEntryWeight

    Last Updated:Jun 12, 2026

    Memanggil operasi ModifyVpnRouteEntryWeight untuk memodifikasi bobot rute tujuan.

    Deskripsi operasi

    Catatan

    Operasi ini hanya berlaku untuk instance gateway VPN yang mendukung koneksi IPsec-VPN dalam mode terowongan tunggal. Untuk instance gateway VPN yang mendukung koneksi IPsec-VPN dalam mode terowongan ganda, bobot tidak berlaku meskipun Anda berhasil memodifikasinya dengan memanggil operasi ini.

    • Jika rute tujuan primer dan sekunder ada pada instance gateway VPN dan Anda ingin memodifikasi bobot rute tujuan primer, Anda harus terlebih dahulu menghapus rute tujuan sekunder. Setelah rute tujuan primer dimodifikasi, konfigurasikan kembali rute tujuan sekunder. Untuk memodifikasi bobot rute tujuan sekunder, Anda harus terlebih dahulu menghapus rute tujuan primer. Setelah rute tujuan sekunder dimodifikasi, konfigurasikan kembali rute tujuan primer. Untuk menghapus rute tujuan, lihat DeleteVpnRouteEntry.

    • ModifyVpnRouteEntryWeight adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID permintaan, tetapi bobot rute tujuan VPN tidak dimodifikasi dengan segera. Sistem melakukan tugas modifikasi di latar belakang. Anda dapat memanggil operasi DescribeVpnGateway untuk mengkueri status modifikasi bobot rute tujuan VPN:

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

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

    • ModifyVpnRouteEntryWeight tidak mengizinkan Anda memodifikasi bobot rute tujuan secara bersamaan 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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah tempat instance gateway VPN berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

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

    Catatan

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

    d7d24a21-f4ba-4454-9173-b3828dae492b
    VpnGatewayId

    string

    Yes

    ID gateway VPN.

    vpn-bp1a3kqjiiq9legfx****
    RouteDest

    string

    Yes

    Blok CIDR tujuan dari rute tujuan.

    10.0.0.0/24
    NextHop

    string

    Yes

    Hop berikutnya dari rute tujuan.

    vco-bp15oes1py4i66rmd****

    Weight

    integer

    Yes

    Bobot rute tujuan sebelum modifikasi. Nilai yang valid:

    • 0: prioritas rendah.

    • 100: prioritas tinggi.

    0
    NewWeight

    integer

    Yes

    Bobot baru dari rute tujuan. Nilai yang valid:

    • 0: prioritas rendah.

    • 100: prioritas tinggi.

    100
    OverlayMode

    string

    No

    Protokol tunneling. Atur nilainya ke Ipsec, yang menentukan protokol tunneling 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.
    400 VpnRouteEntry.Conflict The specified route entry has conflict.
    400 VpnRouteEntry.BackupRoute Validate backup route entry failed.
    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.
    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.