建立路由器介面。

調用本介面建立路由器介面時,請注意:
  • 任意兩個路由器之間,最多隻能存在一對互連的路由器介面。

  • 一個路由器上可以最多建立5個路由器介面。

  • 如果賬戶下存在欠費狀態的路由器介面,則無法建立更多的路由器介面。

  • 同一路由表下的路由條目的目標網段(DestinationCidrBlock)不允許相同。

  • 邊界路由器(VBR)的路由器介面能是串連發起端。

  • 在只能在處於Active狀態VBR上建立路由器介面。

請求參數

名稱 類型 是否必須 描述
Action String

要執行的操作。 取值:

CreateRouterInterface

RegionId String

路由器介面所在的地域。

您可以通過調用 DescribeRegions介面獲取地域ID。

RouterType String

路由器介面關聯的路由器類型。取值:

  • VRouter:VPC路由器

  • VBR:邊界路由器

AccessPointId String

VBR所屬的存取點ID。

您可以通過調用 DescribeAccessPoints介面獲取物理專線存取點ID。

说明
物理專線接入場景下需指定該參數。
RouterId String

路由器介面關聯的路由器ID。

Role String

路由器介面的角色,取值:

  • InitiatingSide:串連發起端。

  • AcceptingSide:串連接收端。

Spec String

路由器介面的規格。可用的規格和對應的頻寬如下:

  • 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: 1000 Mbps

  • Large.2:2000 Mbps

  • Large.5: 5000 Mbps

  • Xlarge.1:10000 Mbps

OppositeRegionId String

串連接收端所在的地域。

OppositeAccessPointId String 對端所屬的存取點ID。
说明
對端路由器介面位於VBR上時需指定該參數,建立路由器介面後無法修改。
OppositeRouterType String

對端路由器介面關聯的路由器類型。取值:

  • VRouter:VPC路由器

  • VBR:邊界路由器

OppositeRouterId String

對端的路由器的ID。

OppositeInterfaceId String

對端路由器介面ID。

OppositeInterfaceOwnerId String

對端路由器介面的所有者ID。

HealthCheckSourceIp String

健康檢查源IP地址,必須是本端VPC內的一個未被使用的IP。

说明
物理專線接入場景下可指定該參數。
HealthCheckTargetIp String

健康檢查目的IP地址。

说明
該參數為必選,當指定了HealthCheckSourceIp後。
Name String

路由器介面的名稱。

長度為 2-128個字元,必須以字母或中文開頭,可包含數字,點號(.),底線(_)和短橫線(-)。但不能以http://https://開頭。

Description String

路由器介面的描述資訊。

長度為 2-256個字元,必須以字母或中文開頭,但不能以http://https://開頭。

InstanceChargeType String

路由器介面的付費方式。取值:

  • PostPaid(預設值):後付費。

ClientToken String

用戶端token,用於保證請求的等冪性。

由用戶端生成該參數值,要保證在不同請求間唯一,最大不值過64個 ASCII 字元。

返回參數

名稱 類型 描述
RequestId String 請求ID。
RouterInterfaceId String 路由器介面的ID。
OrderId String 訂單號,選擇預付費時返回該參數。

樣本

請求樣本

https://vpc.aliyuncs.com/?Action=CreateRouterInterface
&RegionId=cn-beijing
&Role=InitiatingSide
&OppositeRegionId=cn-beijing
&Spec=Mini.5
&RouterType=VRouter
&RouterId=vrt-2zepuy8qbrq6yhdje53t6
&OppositeRouterId= vrt-2zefso23vmu6xi3jeiw0z
&公共請求參數
返回樣本
  • XML格式

    <?xml version="1.0" encoding="UTF-8"?>
    <CreateRouterInterfaceResponse>
        <RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId>
        <RouterInterfaceId>ri-2ze7fbuohmxxxxxx</RouterInterfaceId>
    </CreateRouterInterfaceResponse>
  • JSON格式

    { 
        "RequestId": "980960B0-2969-40BF-8542-EBB34FD358AB"
        "RouterInterfaceId": "ri-2ze7fbuohmxxxxxx"
    }