All Products
Search

This Product

    Express Connect:CreateVirtualBorderRouter

    Document Center

    Express Connect:CreateVirtualBorderRouter

    Last Updated:Jun 12, 2026

    Memanggil operasi CreateVirtualBorderRouter untuk membuat Virtual Border Router (VBR).

    Deskripsi operasi

    Setelah VBR dibuat, status VBR adalah aktif.

    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 sirkuit Express Connect diterapkan.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-shanghai
    PhysicalConnectionId

    string

    Yes

    ID sirkuit Express Connect.

    Anda dapat membuat VBR untuk sirkuit Express Connect spesifikasi khusus atau sirkuit Express Connect bersama.

    pc-2zextbehcx****
    VbrOwnerId

    integer

    No

    ID akun Alibaba Cloud tempat VBR berada.

    Nilai default adalah ID akun Alibaba Cloud saat ini.

    168811111****
    VlanId

    integer

    Yes

    ID VLAN VBR. Nilai valid: 0 hingga 2999.

    Catatan

    Hanya pemilik sirkuit Express Connect yang dapat menentukan parameter ini. ID VLAN dua VBR pada 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 VBR di sisi Alibaba Cloud. Hanya pemilik VBR yang dapat menentukan atau mengubah atribut ini.

    Parameter ini wajib diisi saat Anda membuat VBR untuk pemilik sirkuit Express Connect.

    192.168.XX.XX
    PeerGatewayIp

    string

    No

    Alamat IP Perangkat gateway di sisi pelanggan VBR. Hanya pemilik VBR yang dapat menentukan atau mengubah atribut ini.

    Parameter ini wajib diisi saat Anda membuat VBR untuk pemilik sirkuit Express Connect.

    116.62.XX.XX
    PeeringSubnetMask

    string

    No

    Subnet mask alamat IP di sisi Alibaba Cloud dan di sisi pelanggan VBR.

    Kedua alamat IP harus berada dalam subnet yang sama.

    255.255.255.252
    Description

    string

    No

    Deskripsi VBR.

    Deskripsi harus memiliki panjang 2 hingga 256 karakter, dan harus diawali dengan huruf atau karakter Tionghoa. Tidak dapat diawali dengan http:// atau https://.

    desc
    Name

    string

    No

    Nama VBR.

    Nama harus memiliki panjang 2 hingga 128 karakter, dan harus diawali dengan huruf atau karakter Tionghoa. Dapat berisi angka, garis bawah (_), dan tanda hubung (-). Tidak dapat diawali dengan http:// atau https://.

    test
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

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

    Catatan

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

    123e4567-e89b-12d3-a456-426655440000
    LocalIpv6GatewayIp

    string

    No

    Alamat IPv6 VBR di sisi Alibaba Cloud. Hanya pemilik VBR yang dapat menentukan atau mengubah atribut ini.

    Parameter ini wajib diisi saat Anda membuat VBR untuk pemilik sirkuit Express Connect.

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

    string

    No

    Alamat IPv6 Perangkat gateway di sisi pelanggan VBR. Hanya pemilik VBR yang dapat menentukan atau mengubah atribut ini.

    Parameter ini wajib diisi saat Anda membuat VBR untuk pemilik sirkuit Express Connect.

    2001:XXXX:4:4:4:4:4:4
    PeeringIpv6SubnetMask

    string

    No

    Subnet mask alamat IPv6 di sisi Alibaba Cloud dan di sisi pelanggan VBR.

    Kedua alamat IPv6 harus berada dalam subnet yang sama.

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

    boolean

    No

    Apakah akan mengaktifkan IPv6. Nilai valid:

    • true: Mengaktifkan IPv6.

    • false (default): Menonaktifkan IPv6.

    true
    Bandwidth

    integer

    No

    Bandwidth VBR. Unit: Mbit/s.

    • Saat Anda membuat VBR untuk sirkuit Express Connect spesifikasi khusus, nilai valid adalah 50, 100, 200, 300, 400, 500, 1000, 2048, 5120, 8192, 10240, 20480, 40960, 50120, 61440, dan 102400.

    • Saat Anda membuat VBR untuk sirkuit Express Connect bersama, Anda tidak perlu menentukan bandwidth. Bandwidth VBR adalah bandwidth sirkuit Express Connect bersama yang ditentukan saat sirkuit Express Connect bersama dibuat.

    100
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    Untuk informasi selengkapnya tentang kelompok sumber daya, lihat Apa itu kelompok sumber daya?.

    rg-acfmxazb4ph6aiy****
    Tags

    array<object>

    No

    Tag resource.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag. Anda dapat menentukan paling banyak 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

    Kunci tag dapat memiliki panjang hingga 128 karakter dan tidak dapat diawali dengan aliyun atau acs:. Tidak dapat berisi http:// atau https://.

    FinanceDept
    Value

    string

    No

    Nilai tag. Anda dapat menentukan paling banyak 20 nilai tag. Nilai tag dapat berupa string kosong.

    Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak dapat diawali dengan aliyun atau acs:. Tidak dapat berisi http:// atau https://.

    FinanceJoshua

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Informasi yang dikembalikan.

    VbrId

    string

    ID VBR.

    vbr-bp1jcg5cmxjbl9xgc****
    RequestId

    string

    ID permintaan.

    4EC47282-1B74-4534-BD0E-403F3EE64CAF

    Contoh

    Respons sukses

    JSONformat

    {
  "VbrId": "vbr-bp1jcg5cmxjbl9xgc****",
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 OperationFailed.PconnAllocateVlan0 Vlan 0 Vbr cannot share the physical connection with another Vbr.
    400 IllegalParam.IpAddress The specified IpAddress (%s) is illegal.
    400 IllegalParam.CidrBlock The specified CidrBlock (%s) is illegal.
    400 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId is not found.
    400 InvalidVlanId.Used The specified VlanId has been used.
    400 MissingParameter The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied.
    400 InvalidPhysicalConnectionId.NotEnabled The specified PhysicalConnectionId is not in Enabled state.
    400 InvalidVlanId.Malformed The specified VlanId is not valid.
    400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid.
    400 InvalidLocalGatewayIp.Malformed The specified LocalGatewayIp 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 QuotaExceeded.vbrPerpConn Virtual boarder router per PhysicalConnection quota exceed.
    400 QuotaExceeded.freevbr Free virtual boarder router quota exceed.
    400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet.
    400 TaskConflict The operation is too frequent, please wait a moment and try again.
    400 QuotaExceeded.CrossUserVBRPerUser Cross virtual boarder router per user quota exceed.
    400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use.
    400 QuotaExceeded.SameAccountVBRPerPconn Same account virtual boarder router per physicalConnection quota exceed.
    400 QuotaExceeded.VbrPerPconnPortSpec Quota exceed for current port spec
    400 QuotaExceeded.VbrPerAccessDevice Virtual boarder router per access device quota exceed.
    400 OperationUnsupported.IPV6ForThisRegion This Region do not support IPV6.
    400 VbrBandwidthExceed VBR bandwidth exceed for this physical connection.
    400 OperationFailed.PconnExistVlan0Vbr The physical connection has VLAN 0 VBR. You cannot create another VBR.
    400 OperationFailed.Vlan0VbrUnSharePconn VLAN 0 VBR cannot share the physical connection with another VBR.
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable.
    400 ResourceNotEnough.Bandwidth The specified resource of Bandwidth is not enough.
    400 OperationUnsupported.VirtualBorderRouterEnableIPv6 The operation failed. The device or region does not support IPv6 functions.
    400 IllegalParam.OwnerAliUid The param of VbrOwnerId is illegal.
    400 Forbidden.OwnerAliUid RAM account or Partner account is forbidden to be OwnerAliUid.
    400 OperationDenied.VPconn Vpconn is forbidden to create vbr for another account.
    400 OperationFailed.NotConsistentWithVpconn VBR bandwidth is not consistent with vpconn
    400 IllegalParam.Bandwidth The param of bandwidth is illegal.
    400 OperationFailed.VirtualPhysicalConnectionExistVBR The virtual physical connect has already created another VBR.
    400 ResourceNotInResourceGroup The specified resource is not in the specified ResourceGroup.
    400 IncorrectStatus.VirtualPhysicalConnection The status of PhysicalConnection [%s] is incorrect.
    400 EcAssociatedQoSPconnNotAllowCreateCrossAccountVbr The specified Pconn associated with Qos is not allowed to create cross account VBR.Please contact the business manager.
    400 OperationFailed.VbrBandWidthMust0InVlan0Vbr The operation is failed because of VbrBandWidthMust0InVlan0Vbr.
    400 OperationDenied.PhysicalConnectionNotSupportMPBGPAndMPBGP-v6 The operation is not allowed because this physical connection not support MPBGP and MPBGP-v6.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    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.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.
    404 InvalidVbrOwnerId.NotFound The specified VbrOwnerId is not valid.
    404 CROSS_BID.FORBIDDEN Create VBR across bid is illegal
    404 OperationFailed.AccessDeviceDisabled Access device is disabled and can not create vbr.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.