All Products
Search

This Product

    Express Connect:ModifyVirtualBorderRouterAttribute

    Document Center

    Express Connect:ModifyVirtualBorderRouterAttribute

    Last Updated:Jun 12, 2026

    Memanggil operasi ModifyVirtualBorderRouterAttribute untuk mengubah konfigurasi virtual border router (VBR).

    Deskripsi operasi

    • VlanId hanya dapat diubah oleh pemilik sirkuit Express Connect.

    • ID VLAN yang sama pada sirkuit Express Connect yang sama tidak dapat digunakan oleh dua VBR secara bersamaan.

    • ID VLAN dari VBR yang memasuki status terminated secara otomatis dipertahankan selama 7 hari. Selama periode ini, ID VLAN tidak dapat digunakan oleh VBR lain. Setelah 7 hari, ID VLAN dapat digunakan oleh VBR lain.

    • Untuk instance VBR dari akun lain, Anda tidak dapat mengkonfigurasi LocalGatewayIp, PeerGatewayIp, dan PeeringSubnetMask.

    • PeeringSubnetMask mendukung 24 hingga 30 bit (255.255.255.0 hingga 255.255.255.252).

    • LocalGatewayIp dan PeerGatewayIp harus berada dalam segmen jaringan yang sama. Sebagai contoh, LocalGatewayIp: 192.168.XX.XX, PeerGatewayIp: 192.168.XX.XX, PeeringSubnetMask: 255.255.255.248.

    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 region tempat VBR di-deploy.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID region.

    cn-shanghai
    VbrId

    string

    Yes

    ID instance VBR.

    vbr-bp1lhl0taikrte****
    VlanId

    integer

    No

    ID VLAN dari VBR. Nilai yang valid: 0 hingga 2999.

    Catatan

    Hanya pemilik sirkuit Express Connect yang dapat menentukan parameter ini. ID VLAN dari dua VBR di bawah sirkuit Express Connect yang sama harus berbeda.

    0
    CircuitCode

    string

    No

    Kode sirkuit yang disediakan oleh penyedia layanan internet (ISP) untuk sirkuit Express Connect.

    Catatan

    Hanya pemilik sirkuit Express Connect yang dapat menentukan parameter ini.

    longtel001
    LocalGatewayIp

    string

    No

    Alamat IP sisi Alibaba Cloud dari instance VBR.

    Hanya pemilik VBR yang dapat menentukan atau mengubah properti ini.

    192.168.XX.XX
    PeerGatewayIp

    string

    No

    Alamat IP sisi pelanggan dari instance VBR.

    Hanya pemilik VBR yang dapat menentukan atau mengubah properti ini.

    192.168.XX.X
    PeeringSubnetMask

    string

    No

    Subnet mask dari alamat IP sisi Alibaba Cloud dan alamat IP sisi pelanggan dari instance VBR. Hanya pemilik VBR yang dapat menentukan atau mengubah properti ini.

    Kedua alamat IP harus berada dalam subnet yang sama.

    255.255.255.252
    MinTxInterval

    integer

    No

    Interval minimum pengiriman paket BFD. Nilai yang valid: 200 hingga 1000. Unit: ms.

    300
    MinRxInterval

    integer

    No

    Interval minimum penerimaan paket BFD. Nilai yang valid: 200 hingga 1000. Unit: ms.

    300
    DetectMultiplier

    integer

    No

    Pengganda waktu deteksi. Menentukan jumlah maksimum kehilangan paket koneksi yang diizinkan oleh penerima untuk dikirim oleh pengirim. Digunakan untuk mendeteksi apakah tautan dalam keadaan normal.

    Nilai yang valid: 3 hingga 10.

    3
    Description

    string

    No

    Deskripsi VBR.

    Deskripsi harus terdiri dari 2 hingga 256 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Deskripsi tidak boleh diawali dengan http:// atau https://.

    desc
    Name

    string

    No

    Nama VBR.

    Nama harus terdiri dari 2 hingga 128 karakter dan dapat berisi angka, garis bawah (_), dan tanda hubung (-). Nama harus diawali dengan huruf atau karakter Tionghoa. Nama tidak boleh diawali dengan http:// atau https://.

    VBR
    AssociatedPhysicalConnections

    string

    No

    Daftar sirkuit Express Connect yang terkait dengan VBR, termasuk parameter berikut:

    • VlanId: ID VLAN dari instance VBR.

    • CircuitCode: kode sirkuit yang disediakan oleh ISP untuk sirkuit Express Connect.

    • LocalGatewayIp: alamat IP sisi Alibaba Cloud dari instance VBR.

    • PeerGatewayIp: alamat IP sisi pelanggan dari instance VBR.

    • PeeringSubnetMask: subnet mask dari alamat IP sisi Alibaba Cloud dan alamat IP sisi pelanggan dari instance VBR.

    • LocalIpv6GatewayIp: alamat IPv6 sisi Alibaba Cloud dari instance VBR.

    • PeerIpv6GatewayIp: alamat IPv6 sisi pelanggan dari instance VBR.

    • PeeringIpv6SubnetMask: subnet mask dari alamat IPv6 sisi Alibaba Cloud dan alamat IPv6 sisi pelanggan dari instance VBR.

    • ipv6Enable: mengaktifkan IPv6.

    • PhysicalConnectionId: ID instance sirkuit Express Connect.

    [ { "VlanId": "5", "CircuitCode": "longtel001", "LocalGatewayIp": "192.168.XX.XX", "PeerGatewayIp": "192.168.XX.XX", "PeeringSubnetMask": "255.255.255.252", "LocalIpv6GatewayIp": "fd00:XXXX:1030:3f41::1", "PeerIpv6GatewayIp": "fd00:XXXX:1030:3f41::2", "PeeringIpv6SubnetMask": "fd00:0:1030:3f41::/126", "ipv6Enable": true, "PhysicalConnectionId": "pc-kojok19****" } ]
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa nilainya unik di antara permintaan yang berbeda. ClientToken hanya mendukung karakter ASCII.

    Catatan

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

    02fb3da4-130e-11e9-8e44-00****
    LocalIpv6GatewayIp

    string

    No

    Alamat IPv6 sisi Alibaba Cloud dari instance VBR.

    2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
    PeerIpv6GatewayIp

    string

    No

    Alamat IPv6 sisi pelanggan dari instance VBR.

    • Hanya pemilik VBR yang dapat menentukan atau mengubah properti ini.

    • Parameter ini wajib diisi ketika Anda membuat instance VBR untuk pemilik sirkuit Express Connect. Parameter ini tidak wajib diisi ketika Anda membuat instance VBR untuk akun lain.

    2001:XXXX:3c4d:0015:0000:0000:0000:2a2b
    PeeringIpv6SubnetMask

    string

    No

    Subnet mask dari alamat IPv6 sisi Alibaba Cloud dan alamat IPv6 sisi pelanggan dari instance VBR.

    Kedua alamat IPv6 harus berada dalam subnet yang sama.

    2408:4004:cc:400::/56
    EnableIpv6

    boolean

    No

    Menentukan apakah akan mengaktifkan IPv6.

    • true: mengaktifkan IPv6.

    • false (default): menonaktifkan IPv6.

    false
    Bandwidth

    integer

    No

    Nilai bandwidth. Unit: Mbps.

    100
    SitelinkEnable

    boolean

    No

    Menentukan apakah akan mengaktifkan akses layanan antar-IDC.

    • true: mengaktifkan akses layanan antar-IDC.

    • false (default): menonaktifkan akses layanan antar-IDC.

    false
    Mtu

    integer

    No

    Nilai MTU yang didukung oleh VBR. Nilai yang valid: 1500 dan 8500. Nilai ini hanya dapat diatur ketika VBR terikat ke ECR. Nilai juga memengaruhi semua VBR dan VPC lain dalam ECR yang sama.

    1500

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ID permintaan.

    RequestId

    string

    ID permintaan.

    980960B0-2969-40BF-8542-EBB34FD358AB

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "980960B0-2969-40BF-8542-EBB34FD358AB"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalParam.AssociatedPhysicalConnections The specified AssociatedPhysicalConnections is illegal.
    400 IllegalParam.IpAddress The specified IpAddress is illegal.
    400 IllegalParam.CidrBlock The specified CidrBlock is illegal.
    400 InvalidVbrId.NotFound The specified VirutalBorderRouter is not found.
    400 IllegalParam.MinTxInterval The specified MinTxInterval is not in proper range.
    400 IllegalParam.MinRxInterval The specified MinRxInterval is not in proper range.
    400 IllegalParam.DetectMultiplier The specified DetectMultiplier is not in proper range.
    400 InvalidVlanId.Used The specified VlanId has been used.
    400 Duplicated.LocalGatewayIp The specified LocalGatewayIps are duplicated.
    400 Duplicated.PeerGatewayIp The specified PeerGatewayIp are duplicated.
    400 IllegalParam.LocalGatewayIp The specified LocalGatewayIp already exists.
    400 IllegalParam.PeerGatewayIp The specified PeerGatewayIp already exists.
    400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid.
    400 InvalidVlanId.Malformed The specified VlanId is not valid.
    400 InvalidIp.Malformed The specified ip address is not valid.
    400 InvalidPeeringSubnetMask.Malformed The specified PeeringSubnetMask is not valid.
    400 InvalidName.Malformed The specified Name is not valid.
    400 InvalidDescription.Malformed The specifid Description is not valid.
    400 MissingParameter LocalGatewayIp, peerGatewayIp and peeringSubnetMask must not be null.
    400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet.
    400 InvalidParameter %s
    400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use.
    400 IncorrectStatus.VirtualBorderRouter %s
    400 OperationUnsupported.IPV6ForThisRegion This Region do not support IPV6.
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable.
    400 OperationDenied.VBRAssociateVPconn The operation is not allowed because of VBRAssociateVPconn.
    400 OperationFailed.PhysicalConnectionFinancialLocked Update failed, the physical connection is financial locked.
    400 OperationFailed.PhysicalConnectionTerminated Update failed, the physical connection is terminated.
    400 OperationFailed.VbrBandWidthMust0InVlan0Vbr The operation is failed because of VbrBandWidthMust0InVlan0Vbr.
    400 MissingParam.DetectMultiplier The parameter DetectMultiplier is mandatory.
    400 MissingParam.MinRxInterval The parameter MinRxInterval is mandatory.
    400 MissingParam.MinTxInterval The parameter MinTxInterval is mandatory.
    400 DuplicatedParam.LocalGatewayIp The LocalGatewayIp values are duplicated.
    400 OperationUnsupported.VirtualBorderRouterEnableIPv6 The operation failed. The device or region does not support IPv6 functions.
    400 OperationFailed.PconnAllocateVlan0 Vlan 0 Vbr cannot share the physical connection with another Vbr.
    400 IllegalParam.VlanId The parameter VlanId is illegal.
    400 OperationFailed.VbrLocked The VBR is locked.
    400 IllegalParam.%s The param of %s is illegal.
    400 OperationDenied.NotInWhiteList User does not have permission to turn on jumbo frames.
    400 IncorrectStatus.Ecr The express connect router is not in a steady state and cannot operate.
    400 ResourceInConfiguring.NodeId The express connect router subinstance is not in a steady state and cannot operate.
    400 UnsupportedFeature.JumboFrame The jumbo frame feature is not supported in the current region.
    403 Forbidden.CircuitCodeNotAllowedByCaller The caller is not allowed to modify.
    403 Forbidden.LocalGatewayIpNotAllowedByCaller The caller is not allowed to specify the LocalGatewayIp parameter.
    403 Forbidden.PeerGatewayIpNotAllowedByCaller The caller is not allowed to specify the PeerGatewayIp parameter.
    403 Forbidden.PeeringSubnetMaskNotAllowedByCaller The caller is not allowed to specify the PeeringSubnetMask parameter.
    403 Forbidden.VlanIdNotAllowedByCaller The caller is not allowed to specify the VlanId.
    403 Forbidden.NameNotAllowedByCaller The caller is not allowed to specify the Name parameter.
    403 Forbidden.DescriptionNotAllowedByCaller The caller is not allowed to specify the Description parameter.
    404 InvalidRegionId.NotFound The specified RegionId is not found.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.