All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::VPC::RouterInterface

Last Updated:Mar 28, 2026

Resource ALIYUN::VPC::RouterInterface digunakan untuk membuat antarmuka router.

Sintaksis

{
  "Type": "ALIYUN::VPC::RouterInterface",
  "Properties": {
    "OppositeRegionId": String,
    "Description": String,
    "HealthCheckSourceIp": String,
    "RouterType": String,
    "AccessPointId": String,
    "RouterId": String,
    "Role": String,
    "OppositeInterfaceOwnerId": String,
    "OppositeAccessPointId": String,
    "OppositeInterfaceId": String,
    "HealthCheckTargetIp": String,
    "OppositeRouterId": String,
    "Spec": String,
    "OppositeRouterType": String,
    "Name": String,
    "PricingCycle": String, 
    "Period": Number, 
    "AutoPay": Boolean, 
    "InstanceChargeType": String,
    "ResourceGroupId": String,
    "AutoRenew": Boolean,
    "FastLinkMode": Boolean
  }
}

Properti

Parameter

Tipe

Wajib

Pembaruan diizinkan

Deskripsi

Batasan

RouterId

String

Ya

Tidak

ID router tempat antarmuka router tersebut berada.

Tidak ada.

Role

String

Ya

Tidak

Peran antarmuka router dalam koneksi. Antarmuka router dapat berperan sebagai initiator atau acceptor.

Nilai yang valid:

  • InitiatingSide

    Nilainya harus InitiatingSide jika RouterType diatur ke VBR.

  • AcceptingSide

    Nilainya harus AcceptingSide jika OppositeRouterType diatur ke VBR.

RouterType

String

Tidak

Tidak

Tipe router tempat antarmuka router tersebut berada.

Nilai yang valid:

  • VRouter: router VPC.

  • VBR: virtual border router (VBR).

AccessPointId

String

Tidak

Tidak

ID titik akses.

Jika RouterType diatur ke VBR, parameter ini wajib dan tidak dapat diubah setelah pembuatan. Anda tidak boleh menentukan parameter ini jika RouterType diatur ke VRouter.

Spec

String

Tidak

Tidak

Spesifikasi antarmuka router.

Spesifikasi yang tersedia dan bandwidth-nya masing-masing:

  • Mini.2: 2 Mbps

  • Mini.5: 5 Mbps

  • Small.1: 10 Mbps

  • Small.2: 20 Mbps

  • Small.5: 50 Mbps

  • Middle.1: 100 Mbps

  • Middle.2: 200 Mbps

  • Middle.5: 500 Mbps

  • Large.1: 1.000 Mbps

  • Large.2: 2.000 Mbps

  • Large.5: 5.000 Mbps

  • Xlarge.1: 10.000 Mbps

Parameter ini wajib jika Role diatur ke InitiatingSide.

Jika Role diatur ke AcceptingSide, parameter ini secara default bernilai Negative.

OppositeRegionId

String

Tidak

Tidak

Wilayah tempat antarmuka router peer berada.

Tidak ada.

OppositeInterfaceOwnerId

String

Tidak

Ya

ID Akun Alibaba Cloud pemilik antarmuka router peer.

Secara default menggunakan ID akun saat ini.

OppositeInterfaceId

String

Tidak

Ya

ID antarmuka router peer.

Tidak ada.

OppositeRouterId

String

Tidak

Ya

ID router peer.

Tidak ada.

OppositeRouterType

String

Tidak

Ya

Tipe router peer.

Nilai yang valid:

  • VRouter: vRouter VPC.

    Nilainya harus VRouter jika RouterType diatur ke VBR.

  • VBR: virtual border router (VBR).

OppositeAccessPointId

String

Tidak

Tidak

ID titik akses peer.

Jika OppositeRouterType diatur ke VBR, parameter ini wajib dan tidak dapat diubah setelah pembuatan.

Anda tidak boleh menentukan parameter ini jika OppositeRouterType diatur ke VRouter.

Catatan

Jika OppositeRouterType diatur ke VBR, VBR yang ditentukan oleh OppositeRouterId harus berada dalam titik akses yang ditentukan oleh OppositeAccessPointId.

Description

String

Tidak

Ya

Deskripsi antarmuka router.

Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai denganhttp:// atauhttps://.

Secara default, parameter ini kosong.

Name

String

Tidak

Ya

Nama antarmuka router.

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

ResourceGroupId

String

Tidak

Tidak

ID kelompok sumber daya.

Tidak ada.

AutoRenew

Boolean

Tidak

Tidak

Menentukan apakah perpanjangan otomatis diaktifkan.

Tidak ada.

FastLinkMode

Boolean

Tidak

Tidak

Menentukan apakah koneksi VBR-ke-VPC dibuat dalam mode koneksi cepat.

Mode koneksi cepat memungkinkan sistem secara otomatis menghubungkan antarmuka router yang dibuat pada VBR dan VPC. Nilai yang valid:

  • true

  • false (default)

Catatan

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

  • Jika FastLinkMode diatur ke true, Role harus diatur ke InitiatingSide, dan parameter AccessPointId, OppositeRouterType, OppositeRouterId, serta OppositeInterfaceOwnerId wajib ditentukan.

HealthCheckSourceIp

String

Tidak

Tidak

Alamat IP sumber untuk paket pemeriksaan kesehatan. Parameter ini digunakan untuk pemeriksaan kesehatan dalam skenario disaster recovery jalur sewa dan ECMP.

Parameter ini hanya berlaku untuk antarmuka router pada vRouter VPC yang memiliki peer pada VBR. Alamat IP harus merupakan alamat IP yang tidak digunakan dalam VPC milik vRouter tersebut. Anda harus menentukan kedua parameter HealthCheckSourceIp dan HealthCheckTargetIp, atau tidak menentukan keduanya.

HealthCheckTargetIp

String

Tidak

Tidak

Alamat IP tujuan untuk paket pemeriksaan kesehatan. Parameter ini digunakan untuk pemeriksaan kesehatan dalam skenario disaster recovery jalur sewa dan ECMP.

Parameter ini hanya berlaku untuk antarmuka router pada vRouter VPC yang memiliki peer pada VBR. Anda dapat menggunakan alamat IP perangkat di tempat pelanggan (CPE), yaitu PeerGatewayIp pada VBR peer. Anda juga dapat menentukan alamat IP lain di sisi pelanggan. Anda harus menentukan kedua parameter HealthCheckSourceIp dan HealthCheckTargetIp, atau tidak menentukan keduanya.

PricingCycle

String

Tidak

Tidak

Siklus penagihan langganan.

Nilai yang valid:

  • Month

  • Year

Period

Number

Tidak

Tidak

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.

AutoPay

Boolean

Tidak

Tidak

Menentukan apakah pembayaran otomatis diaktifkan.

Nilai yang valid:

  • true (default)

  • false

InstanceChargeType

String

Tidak

Tidak

Metode penagihan antarmuka router.

Nilai yang valid:

  • Postpaid: pay-as-you-go.

  • Prepaid: subscription.

Nilai kembalian

Fn::GetAtt

RouterInterfaceId: ID antarmuka router yang dibuat.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  OppositeInterfaceId:
    Type: String
    Description: The ID of the peer router interface.
  RouterId:
    Type: String
    Description: The ID of the router on which the router interface is created.
  OppositeRouterId:
    Type: String
    Description: The ID of the peer router.
Resources:
  RouterInterface:
    Type: ALIYUN::VPC::RouterInterface
    Properties:
      OppositeInterfaceId:
        Ref: OppositeInterfaceId
      OppositeRouterId:
        Ref: OppositeRouterId
      OppositeInterfaceOwnerId:
        Ref: ALIYUN::TenantId
      OppositeRouterType: VRouter
      Description: Initiating Side
      RouterType: VRouter
      RouterId:
        Ref: RouterId
      Role: InitiatingSide
      Spec: Mini.2
      InstanceChargeType: PostPaid
Outputs:
  RouterInterfaceId:
    Description: The ID of the created RouterInterface.
    Value:
      Fn::GetAtt:
        - RouterInterface
        - RouterInterfaceId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "OppositeInterfaceId": {
      "Type": "String",
      "Description": "The ID of the peer router interface."
    },
    "RouterId": {
      "Type": "String",
      "Description": "The ID of the router on which the router interface is created."
    },
    "OppositeRouterId": {
      "Type": "String",
      "Description": "The ID of the peer router."
    }
  },
  "Resources": {
    "RouterInterface": {
      "Type": "ALIYUN::VPC::RouterInterface",
      "Properties": {
        "OppositeInterfaceId": {
          "Ref": "OppositeInterfaceId"
        },
        "OppositeRouterId": {
          "Ref": "OppositeRouterId"
        },
        "OppositeInterfaceOwnerId": {
          "Ref": "ALIYUN::TenantId"
        },
        "OppositeRouterType": "VRouter",
        "Description": "Initiating Side",
        "RouterType": "VRouter",
        "RouterId": {
          "Ref": "RouterId"
        },
        "Role": "InitiatingSide",
        "Spec": "Mini.2",
        "InstanceChargeType": "PostPaid"
      }
    }
  },
  "Outputs": {
    "RouterInterfaceId": {
      "Description": "The ID of the created RouterInterface.",
      "Value": {
        "Fn::GetAtt": [
          "RouterInterface",
          "RouterInterfaceId"
        ]
      }
    }
  }
}