建立路由器介面。
-
任意兩個路由器之間,最多隻能存在一對互連的路由器介面。
-
一個路由器上可以最多建立5個路由器介面。
-
如果賬戶下存在欠費狀態的路由器介面,則無法建立更多的路由器介面。
-
同一路由表下的路由條目的目標網段(DestinationCidrBlock)不允許相同。
-
邊界路由器(VBR)的路由器介面能是串連發起端。
- 在只能在處於Active狀態VBR上建立路由器介面。
請求參數
名稱 | 類型 | 是否必須 | 描述 | |||
---|---|---|---|---|---|---|
Action | String | 是 | 要執行的操作。 取值: CreateRouterInterface |
|||
RegionId | String | 是 | 路由器介面所在的地域。 您可以通過調用 DescribeRegions介面獲取地域ID。 |
|||
RouterType | String | 是 | 路由器介面關聯的路由器類型。取值:
|
|||
AccessPointId | String | 否 | VBR所屬的存取點ID。 您可以通過調用 DescribeAccessPoints介面獲取物理專線存取點ID。
|
|||
RouterId | String | 是 | 路由器介面關聯的路由器ID。 |
|||
Role | String | 是 | 路由器介面的角色,取值:
|
|||
Spec | String | 是 | 路由器介面的規格。可用的規格和對應的頻寬如下:
|
|||
OppositeRegionId | String | 是 | 串連接收端所在的地域。 |
|||
OppositeAccessPointId | String | 否 | 對端所屬的存取點ID。
|
|||
OppositeRouterType | String | 否 | 對端路由器介面關聯的路由器類型。取值:
|
|||
OppositeRouterId | String | 否 | 對端的路由器的ID。 |
|||
OppositeInterfaceId | String | 否 | 對端路由器介面ID。 |
|||
OppositeInterfaceOwnerId | String | 否 | 對端路由器介面的所有者ID。 |
|||
HealthCheckSourceIp | String | 否 | 健康檢查源IP地址,必須是本端VPC內的一個未被使用的IP。
|
|||
HealthCheckTargetIp | String | 否 | 健康檢查目的IP地址。
|
|||
Name | String | 否 | 路由器介面的名稱。 長度為 2-128個字元,必須以字母或中文開頭,可包含數字,點號(.),底線(_)和短橫線(-)。但不能以 |
|||
Description | String | 否 | 路由器介面的描述資訊。 長度為 2-256個字元,必須以字母或中文開頭,但不能以 |
|||
InstanceChargeType | String | 否 | 路由器介面的付費方式。取值:
|
|||
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" }