All Products
Search

This Product

    Express Connect:CreateVirtualBorderRouter

    Document Center

    Express Connect:CreateVirtualBorderRouter

    Last Updated:Sep 18, 2026

    Membuat instans Virtual Border Router (VBR).

    Deskripsi operasi

    Setelah instans VBR dibuat, status instans VBR adalah active.

    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:CreateVirtualBorderRouter

    create

    *PhysicalConnection.

    acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}

    *VirtualBorderRouter

    acs:vpc:{#regionId}:{#AccountId}:virtualborderrouter/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah sirkuit Express Connect.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    cn-shanghai
    PhysicalConnectionId

    string

    Yes

    ID instans sirkuit Express Connect.

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

    pc-2zextbehcx****
    VbrOwnerId

    integer

    No

    ID akun pemilik instans VBR.

    Nilai default adalah ID akun Alibaba Cloud yang digunakan untuk logon.

    168811111****
    VlanId

    integer

    Yes

    ID VLAN instans VBR. Nilai valid: 0 hingga 2999.

    Catatan

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

    0
    CircuitCode

    string

    No

    Kode sirkuit yang disediakan oleh penyedia layanan 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 instans VBR. Hanya pemilik VBR yang dapat menentukan atau memodifikasi properti ini.

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

    192.168.XX.XX
    PeerGatewayIp

    string

    No

    Alamat IP sisi pelanggan dari instans VBR. Hanya pemilik VBR yang dapat menentukan atau memodifikasi properti ini.

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

    116.62.XX.XX
    PeeringSubnetMask

    string

    No

    Subnet mask untuk alamat IP sisi Alibaba Cloud dan sisi pelanggan dari instans VBR.

    Kedua alamat IP harus berada dalam subnet yang sama.

    255.255.255.252
    Description

    string

    No

    Deskripsi instans VBR.

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

    desc
    Name

    string

    No

    Nama instans VBR.

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

    test
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Klien menghasilkan nilai parameter ini. Pastikan nilai tersebut unik di antara permintaan yang berbeda.

    Catatan

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

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

    string

    No

    Alamat IPv6 sisi Alibaba Cloud dari instans VBR. Hanya pemilik VBR yang dapat menentukan atau memodifikasi properti ini.

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

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

    string

    No

    Alamat IPv6 sisi pelanggan dari instans VBR. Hanya pemilik VBR yang dapat menentukan atau memodifikasi properti ini.

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

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

    string

    No

    Subnet mask untuk alamat IPv6 sisi Alibaba Cloud dan sisi pelanggan dari instans 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: Diaktifkan.

    • false (default): Dinonaktifkan.

    true
    Bandwidth

    integer

    No

    Nilai bandwidth instans VBR. Unit: Mbit/s.

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

    • Saat Anda membuat instans VBR untuk sirkuit Express Connect bersama, Anda tidak perlu mengonfigurasi parameter ini. Bandwidth VBR adalah bandwidth sirkuit Express Connect bersama yang ditentukan di Pengaturan 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 sumber daya.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag sumber daya. Anda harus menentukan minimal 1 kunci tag dan dapat menentukan maksimal 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

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

    FinanceDept
    Value

    string

    No

    Nilai tag sumber daya. Anda dapat menentukan maksimal 20 nilai tag. Nilai tag dapat berupa string kosong.

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

    FinanceJoshua

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    RequestId

    string

    ID permintaan.

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

    string

    ID instans VBR.

    vbr-bp1jcg5cmxjbl9xgc****

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 OperationFailed.PconnAllocateVlan0 Vlan 0 Vbr cannot share the physical connection with another Vbr. VLAN 0 pada sirkuit Express Connect tidak dapat berdampingan dengan Pesanan Virtual Border Router (VBR) lainnya.
    400 IllegalParam.IpAddress The specified IpAddress (%s) is illegal. Alamat IP tidak valid.
    400 IllegalParam.CidrBlock The specified CidrBlock (%s) is illegal. Blok CIDR tidak valid.
    400 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId is not found. ID sirkuit Express Connect yang ditentukan tidak ada.
    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. PeeringSubnetMask yang ditentukan tidak valid. Periksa apakah parameter ini benar.
    400 InvalidName.Malformed The specified ?Name? is not valid.
    400 InvalidDescription.Malformed The specifid ?Description? is not valid. Format deskripsi sumber daya yang ditentukan tidak valid. Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.
    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. Alamat IP gerbang lokal dan alamat IP gerbang peer tidak berada dalam subnet yang sama.
    400 TaskConflict The operation is too frequent, please wait a moment and try again. Operasi EIP terlalu sering.
    400 QuotaExceeded.CrossUserVBRPerUser Cross virtual boarder router per user quota exceed. Kuota telah terlampaui.
    400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use. ID VLAN sudah digunakan.
    400 QuotaExceeded.SameAccountVBRPerPconn Same account virtual boarder router per physicalConnection quota exceed. Kuota VBR telah terlampaui.
    400 QuotaExceeded.VbrPerPconnPortSpec Quota exceed for current port spec Kuota telah terlampaui.
    400 QuotaExceeded.VbrPerAccessDevice Virtual boarder router per access device quota exceed. Kuota perangkat telah terlampaui.
    400 OperationUnsupported.IPV6ForThisRegion This Region do not support IPV6. Wilayah tidak mendukung IPv6.
    400 VbrBandwidthExceed VBR bandwidth exceed for this physical connection. Bandwidth Virtual Border Router melebihi ambang batas pesanan sirkuit Express Connect.
    400 OperationFailed.PconnExistVlan0Vbr The physical connection has VLAN 0 VBR. You cannot create another VBR. VBR VLAN 0 sudah ada pada sirkuit Express Connect. Anda tidak dapat membuat VBR lainnya.
    400 OperationFailed.Vlan0VbrUnSharePconn VLAN 0 VBR cannot share the physical connection with another VBR. VBR VLAN 0 lainnya sudah ada pada sirkuit Express Connect. Anda tidak dapat membuat VBR VLAN 0 pada sirkuit ini.
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. Operasi gagal karena lalu lintas keluar tidak diaktifkan.
    400 ResourceNotEnough.Bandwidth The specified resource of Bandwidth is not enough. Sumber daya bandwidth tidak mencukupi.
    400 OperationUnsupported.VirtualBorderRouterEnableIPv6 The operation failed. The device or region does not support IPv6 functions. Operasi gagal karena perangkat atau wilayah tidak mendukung IPv6.
    400 IllegalParam.OwnerAliUid The param of VbrOwnerId is illegal. ID pengguna adalah parameter yang tidak valid.
    400 Forbidden.OwnerAliUid RAM account or Partner account is forbidden to be OwnerAliUid. VbrOwnerId adalah akun pengguna Resource Access Management (RAM) atau akun mitra, yang tidak diizinkan sebagai akun pemilik VBR.
    400 OperationDenied.VPconn Vpconn is forbidden to create vbr for another account. Tipe Vpconn tidak mendukung operasi ini.
    400 OperationFailed.NotConsistentWithVpconn VBR bandwidth is not consistent with vpconn Nilai bandwidth VBR tidak cocok dengan nilai bandwidth sirkuit Express Connect bersama yang terkait.
    400 IllegalParam.Bandwidth The param of bandwidth is illegal. Nilai bandwidth yang ditentukan tidak valid.
    400 OperationFailed.VirtualPhysicalConnectionExistVBR The virtual physical connect has already created another VBR. VBR sudah ada untuk VirtualPhysicalConnection.
    400 ResourceNotInResourceGroup The specified resource is not in the specified ResourceGroup. Resource yang ditentukan tidak berada dalam kelompok sumber daya yang ditentukan.
    400 IncorrectStatus.VirtualPhysicalConnection The status of PhysicalConnection [%s] is incorrect. Status sirkuit Express Connect bersama [%s] salah.
    400 EcAssociatedQoSPconnNotAllowCreateCrossAccountVbr The specified Pconn associated with Qos is not allowed to create cross account VBR.Please contact the business manager. Anda tidak dapat membuat Virtual Border Router lintas akun pada sirkuit Express Connect bersama yang terasosiasi dengan kebijakan QoS. Hubungi manajer akun Anda.
    400 OperationFailed.VbrBandWidthMust0InVlan0Vbr The operation is failed because of VbrBandWidthMust0InVlan0Vbr. Operasi gagal. Konfigurasi batas bandwidth tidak diizinkan.
    400 OperationDenied.PhysicalConnectionNotSupportMPBGPAndMPBGP-v6 The operation is not allowed because this physical connection not support MPBGP and MPBGP-v6. Operasi tidak diizinkan karena port fisik saat ini tidak mendukung kemampuan lanjutan seperti MPBGP dan MPBGP-v6.
    400 IncorrectBusinessStatus.PhysicalConnection Invalid physical connection business status. Status bisnis saat ini dari sirkuit Express Connect tidak mendukung operasi ini.
    500 InternalError The request processing has failed due to some unknown error, exception or failure. Pemrosesan permintaan gagal karena error yang tidak diketahui.
    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 Koneksi lintas BID tidak diizinkan.
    404 OperationFailed.AccessDeviceDisabled Access device is disabled and can not create vbr. Perangkat akses dinonaktifkan. VBR tidak dapat dibuat.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.