All Products
Search

This Product

    Virtual Private Cloud:CreateRouterInterface

    Document Center

    Virtual Private Cloud:CreateRouterInterface

    Last Updated:Jun 12, 2026

    Memanggil operasi CreateRouterInterface untuk membuat router interface.

    Deskripsi operasi

    Ketika Anda memanggil operasi ini untuk membuat router interface, perhatikan hal-hal berikut:

    • Maksimal satu pasang router interface yang saling terhubung dapat ada di antara dua router.

    • Maksimal lima router interface dapat dibuat pada satu router.

    • Jika terdapat router interface yang telah jatuh tempo (overdue) di akun Anda, Anda tidak dapat membuat router interface tambahan.

    • Blok CIDR tujuan (DestinationCidrBlock) dari entri rute dalam tabel rute yang sama tidak boleh sama.

    • Virtual border router (VBR) hanya dapat menjadi inisiator koneksi, dan harus berada dalam status Active.

    • Operasi ini dapat digunakan untuk membuat router interface yang menggunakan metode penagihan langganan (subscription) atau bayar sesuai pemakaian (pay-as-you-go).

    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 router interface di-deploy.

    Anda dapat memanggil operasi DescribeRegions untuk mendapatkan ID region.

    cn-hangzhou
    Role

    string

    Yes

    Peran dari router interface. Nilai yang valid:

    • InitiatingSide: inisiator koneksi.

    • AcceptingSide: penerima koneksi.

    InitiatingSide
    OppositeRegionId

    string

    Yes

    ID region tempat penerima koneksi di-deploy.

    cn-shanghai
    Spec

    string

    Yes

    Spesifikasi dari router interface. Spesifikasi berikut beserta nilai bandwidth yang sesuai tersedia:

    • Mini.2: 2 Mbit/s

    • Mini.5: 5 Mbit/s

    • Small.1: 10 Mbit/s

    • Small.2: 20 Mbit/s

    • Small.5: 50 Mbit/s

    • Middle.1: 100 Mbit/s

    • Middle.2: 200 Mbit/s

    • Middle.5: 500 Mbit/s

    • Large.1: 1.000 Mbit/s

    • Large.2: 2.000 Mbit/s

    • Large.5: 5.000 Mbit/s

    • Xlarge.1: 10.000 Mbit/s

    Catatan

    Ketika Role diatur ke AcceptingSide (penerima koneksi), nilai Spec harus Negative, yang berarti spesifikasi tidak diperhitungkan ketika Anda membuat router interface sebagai penerima.

    Mini.2
    RouterType

    string

    Yes

    Tipe router yang terhubung dengan router interface. Nilai yang valid:

    • VRouter: vRouter dari sebuah VPC.

    • VBR: virtual border router (VBR).

    VRouter
    RouterId

    string

    Yes

    ID router yang terhubung dengan router interface.

    vbr-m5ebm6g9ptc9mly1c****
    OppositeInterfaceId

    string

    No

    ID dari router interface peer.

    ri-2zeo3xzyf38r4urzd****
    OppositeRouterId

    string

    No

    ID dari router peer.

    vrt-bp1lhl0taikrteen8****
    OppositeRouterType

    string

    No

    Tipe router yang terhubung dengan router interface peer. Nilai yang valid:

    • VRouter: vRouter dari sebuah VPC.

    • VBR: virtual border router (VBR).

    VRouter
    OppositeInterfaceOwnerId

    string

    No

    ID akun Alibaba Cloud tempat router interface peer berada.

    253460731706911258
    HealthCheckSourceIp

    string

    No

    Alamat IP sumber yang digunakan untuk health check. Alamat IP harus merupakan alamat IP yang tidak terpakai di dalam VPC lokal.

    Catatan

    Parameter ini dapat ditentukan dalam skenario express connect.

    192.168.0.6
    HealthCheckTargetIp

    string

    No

    Alamat IP tujuan yang digunakan untuk health check.

    Catatan

    Parameter ini wajib diisi ketika HealthCheckSourceIp ditentukan.

    192.168.0.8
    AccessPointId

    string

    No

    ID access point tempat VBR berada.

    Anda dapat memanggil operasi DescribeAccessPoints untuk mendapatkan ID dari access point sirkuit Express Connect.

    Catatan

    Parameter ini harus ditentukan dalam skenario express connect.

    ap-cn-hangzhou-yh-ts-A
    OppositeAccessPointId

    string

    No

    ID access point tempat ujung peer berada.

    Catatan

    Parameter ini wajib diisi ketika router interface peer berada pada sebuah VBR. Parameter ini tidak dapat diubah setelah router interface dibuat.

    ap-cn-shanghai-nt-aligroup-C
    Description

    string

    No

    Deskripsi dari router interface.

    Deskripsi harus memiliki panjang 2 hingga 256 karakter dan diawali dengan huruf, tetapi tidak boleh diawali dengan http:// atau https://.

    abcabc
    Name

    string

    No

    Nama dari router interface.

    Nama harus memiliki panjang 2 hingga 128 karakter dan diawali dengan huruf. Nama dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-).

    abc
    Period

    integer

    No

    Durasi langganan. Nilai yang valid:

    • Jika PricingCycle diatur ke Month, nilai yang valid adalah 1 hingga 9.

    • Jika PricingCycle diatur ke Year, nilai yang valid adalah 1 hingga 3.

    Catatan

    Parameter ini wajib diisi ketika InstanceChargeType diatur ke PrePaid.

    3
    InstanceChargeType

    string

    No

    Metode penagihan dari router interface. Nilai yang valid:

    • PrePaid: langganan (subscription).

    • PostPaid: bayar sesuai pemakaian (pay-as-you-go).

    PrePaid
    AutoPay

    boolean

    No

    Menentukan apakah akan mengaktifkan pembayaran otomatis. Nilai yang valid:

    • false (default): menonaktifkan pembayaran otomatis. Setelah Anda menghasilkan order, Anda harus menyelesaikan pembayaran di Order Center.

    • true: mengaktifkan pembayaran otomatis. Pembayaran diselesaikan secara otomatis.

    Catatan

    Parameter ini wajib diisi ketika InstanceChargeType diatur ke PrePaid.

    false
    PricingCycle

    string

    No

    Siklus penagihan untuk langganan. Nilai yang valid:

    • Month (default): langganan ditagih per bulan.

    • Year: langganan ditagih per tahun.

    Catatan

    Parameter ini wajib diisi ketika InstanceChargeType diatur ke PrePaid.

    Month
    ClientToken

    string

    No

    Client token yang digunakan untuk memastikan idempotensi dari request.

    Nilainya dihasilkan oleh client dan harus unik di seluruh request.

    Catatan

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

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

    string

    No

    Client token yang digunakan untuk memastikan idempotensi dari request.

    Nilainya dihasilkan oleh client dan harus unik di seluruh request.

    Catatan

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

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

    boolean

    No

    Menentukan apakah router interface uplink dari VBR dibuat dalam mode fast link. Dalam mode fast link, setelah router interface pada VBR dan VPC dibuat, koneksi akan terbentuk secara otomatis. Nilai yang valid:

    • true: ya.

    • false (default): tidak.

    Catatan

    • Parameter ini hanya berlaku ketika RouterType diatur ke VBR dan OppositeRouterType diatur ke VRouter.

    • Ketika FastLinkMode diatur ke true, Role harus diatur ke InitiatingSide, dan AccessPointId, OppositeRouterType, OppsiteRouterId, serta OppositeInterfaceOwnerId wajib diisi.

    false
    AutoRenew

    boolean

    No

    Menentukan apakah akan mengaktifkan perpanjangan otomatis. Nilai yang valid:

    • false (default): menonaktifkan perpanjangan otomatis.

    • true: mengaktifkan perpanjangan otomatis.

    false
    ResourceGroupId

    string

    No

    ID dari resource group.

    Untuk informasi lebih lanjut tentang resource group, lihat What is a resource group.

    rg-acfmxazb4ph6aiy****
    Tags

    array<object>

    No

    Tag dari resource.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag. Anda harus memasukkan setidaknya satu kunci tag dan maksimal 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

    Kunci tag maksimal 128 karakter. Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh berisi http:// atau https://.

    FinanceDept
    Value

    string

    No

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

    Nilai tag maksimal 128 karakter. Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh berisi http:// atau https://.

    FinanceJoshua

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ID dari request.

    RequestId

    string

    ID dari request.

    079874CD-AEC1-43E6-AC03-ADD96B6E4907
    OrderId

    integer

    ID order. Parameter ini dikembalikan ketika metode penagihan langganan dipilih.

    20210101123456
    RouterInterfaceId

    string

    ID dari router interface.

    ri-2ze7fbuohm****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "079874CD-AEC1-43E6-AC03-ADD96B6E4907",
  "OrderId": 20210101123456,
  "RouterInterfaceId": "ri-2ze7fbuohm****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidPrice.NotFound Pricing plan result not found.
    400 InvalidAliuid Invalid Aliuid.
    400 InvalidRole.ValueNotSupported The specified Role is not valid.
    400 InvalidSpec.ValudNotSupported The specified Spec is not supported.
    400 InvalidRouterType.ValueNotSupported The specified RouterType is not valid.
    400 InvalidName.Malformed The specified "Name" is not valid.
    400 Forbidden.BillsOutstanding You cannot create more RouterInterface because you have bills outstanding.
    400 LimitationExceed.InterfaceNumberOnRouter Total number of RouterInterfaces on a Router exceeded.
    400 Forbidden.NotInRouterInterfaceCreateWhitelist Not in router interface create whitelist.
    400 RI_CREATE_ONE_LIMIT_BY_SYNC Create ri only one limit by sync.
    400 InvalidAccessPoint.ValueNotAllowed The non-vbr router interface cannot have access point configured.
    400 InvalidParam.NotFound Parameter must not be null,uid, bid,regionNo, remoteRegionNo, routerId or accessPointId
    400 InvalidAccessPoint.NotMatch The accessPoint id is not matched
    400 InvalidAccessPoint.NotExist The accessPoint not exit
    400 INVAID_VBR_STATUS VBR status must be active
    400 IncorrectStatus.CenStatus Cen status must not be middle status.
    400 Forbidden.AcceptRoleNotSupportPrePay Acception side ri not support chargetype for prepaid.
    400 InvalidRouterInterfaceSpec.Malformed Specified RouterInterface spec is not valid.
    400 VpcSubnet.NotFound Vpc subnet not exist.
    400 IllegalParam.HealthcheckIp Healthcheck ip cannot equal with instance ip.
    400 OperationFailed.HcForInvalidRiType Healthchecksourceip and healthchecktargetip is only valid for vr ri that is connected to vbr.
    400 OperationFailed.SyncOrderToSub SyncOrderToSub error.
    400 IllegalParam.CrossBorderBandwidth CrossBorder bandwidth error.
    400 IllegalParam.VRouterType The VRouterType is not supported.
    400 IllegalParam.Spec The spec is illegal.
    400 Forbidden.CrossBorder User not authorized to create cross border routerInterface.
    400 InvalidRouterId.NotFound Param is not valid,this user does not have this router or aliuid bid regionNo and routerId must have something wrong.
    400 InvalidCommodity.NotFound Commodity is not exist.
    400 InvalidRouterInterfaceChargeType.Malformed Specified RouterInterface ChargeType is not valid.
    400 IllegalParam.RegionId The specified regionId is illegal.
    400 PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL User withhoding argeement is illegal.
    400 QuotaExceeded RiPerUser quota exceeded
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable.
    400 InvalidRegionId.NotFound The regionId provided does not exist in ec region list.
    400 ResourceNotInResourceGroup The specified resource is not in the specified ResourceGroup.
    400 HaveConnectionBetweenRouters Have connection between routers
    400 InvalidDescription.Malformed The specified "Description" is not valid.
    400 InvalidBandwidth.NotEnough Bandwidth not enough.
    400 ForbiddenAction The user does not support this action.
    400 OperationFailed.NotSupportIPv6 Router interface not support IPv6.
    400 InvalidParam.AvailableZoneId The specified AvailableZoneId did not retrieve the corresponding cluster IP address.
    400 OperationFailed.NoAvailableAmount The available amount of your account is less than 0, please recharge before attempting to purchase.
    400 OperationFailed.OperationLocked Operation failed because OperationLocked.
    400 OperationFailed.InvalidEcGrant The VBR have no grant to create EC.
    400 OperationFailed.CannotConnectOtherOwnerInstance Can not connect with other owner VPC or CEN.
    400 InvalidParams.NotNull params must not null.
    404 InvalidRegionId.NotFound The regionId provided does not exist in our records.
    404 InvalidRouterId.NotFound The specified RouterId does not exist in our recored.
    404 InvalidRouterId.AttacedToCEN Can not create ri when attaced to CEN.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.