在VPC路由器或邊界路由器（VBR）上建立自訂路由條目。

使用該介面為專有網路的路由器的路由表添加自訂路由條目時，請注意：

  • 同一個路由表中自訂路由條目不能超過48條。

  • 自訂路由條目的目標網段（DestinationCidrBlock）不能和VPC內的交換器的網段相同，也不能包含交換器的網段或者被交換器的網段包含。

  • 自訂路由條目的目標網段（DestinationCidrBlock）不能指向100.64.0.0/10，也不能被100.64.0.0/10包含。

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

  • 如果指定的目標網段（DestinationCidrBlock）是一個IP地址，會按照32位元遮罩來處理。

  • 多條自訂路由條目可以指向同一個下一跳（NextHopId）。
  • 自訂路由條目的下一跳（NextHopId）必須和路由表在同一個VPC。
  • 支援通過NextHopList參數配置ECMP路由：

    • 添加普通（非 ECMP ）自訂路由時，需指定DestinationCidrBlock、NextHopType和NextHopId參數，且不能指定 NextHopList參數。

    • 添加ECMP路由時，需指定DestinationCidrBlock和NextHopList參數，且不能指定NextHopType 和 NextHopId參數。

使用該介面為VBR的路由表添加自訂路由條目時，請注意：

  • 同一個路由表中自訂路由條目不能超過48條。

  • 不支援NextHopList參數。

  • 自訂路由條目的目標網段（DestinationCidrBlock）不能指向100.64.0.0/10，也不能被100.64.0.0/10包含。

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

  • 如果指定的目標網段（DestinationCidrBlock）是一個IP地址，會按照32位元遮罩來處理。

  • 多條自訂路由條目可以指向同一個下一跳（NextHopId）。
  • 自訂路由條目的下一跳（NextHopId）必須是該VBR關聯的路由器介面。

  • 只允許在VBR狀態是Active，而且對應的物理專線狀態是Enabled且沒有被欠費鎖定的情況下在VBR上新建路由條目。

  • 僅支援添加普通路由（非 ECMP），需指定DestinationCidrBlock、NextHopType和NextHopId參數，且不能指定 NextHopList參數。

請求參數

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

要執行的操作。 取值：

CreateRouteEntry
RouteTableId String 是

路由表ID。
DestinationCidrBlock String 是

自訂路由條的目標網段，需滿足以下要求：

  • 目標網段不能指向100.64.0.0/10或被100.64.0.0/10包含。

  • 同一張路由表內的不同路由條目的目標網段不能相同。

    （預設值）

  • 如果提供的目標網段是一個IP地址，掩碼將按照32位處理。
NextHopType String 否

下一跳的類型。取值：

  • Instance：ECS執行個體（預設值）

    HaVip：高可用虛擬IP

    RouterInterface：路由器介面

    VpnGateway：VPN網關

说明
建立普通（非ECMP路由）路由條目時必須指定該參數。
NextHopId String 否

路由條目的下一跳執行個體ID。

下一跳必須位於路由表所在的VPC或VBR中。

说明
建立普通（非ECMP路由）路由條目時必須指定該參數。
NextHopList List 否

路由條目的下一跳列表，需滿足以下條件：

  • 只支援在VPC中的路由表建立ECMP路由條目。

  • NextHopList中的下一跳數量為2-4個。

  • NextHopList中的下一跳只能是VPC中指向VBR的路由器介面。

说明
建立ECMP路由條目時必須指定該參數。
ClientToken String 否

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

由用戶端生成該參數值，要保證在不同請求間唯一，最大不值過64個 ASCII 字元。
表 1. NextHopList
參數 類型 是否必須 描述
NextHopType String 否

下一跳的類型，取值：

  • Instance：ECS執行個體（預設值）

    HaVip：高可用虛擬IP

    RouterInterface：路由器介面

NextHopId String 否 下一跳執行個體的ID。
Enabled Integer 否 是否啟用下一跳：

  • 0：不可用

  • 1：可用

Weight Integer 否 下一跳的路由權重。

返回參數

名稱 類型 描述
RequestId String 請求ID。

樣本

請求樣本

https://vpc.aliyuncs.com/?Action=CreateRouteEntry
&VpcId=vpc-257gq642n
&RouteTableId=vrt-5citwfp6a
&DestinationCidrBlock=0.0.0.0/0
&NextHopId=i-25skktcp4
&公共請求參數
返回樣本

  • XML格式

    <?xml version="1.0" encoding="UTF-8"?>
<CreateRouteEntryResponse>
    <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
</CreateRouteEntryResponse>

  • JSON格式

    { 
    "RequestId": "12D086F6-8F31-4658-84C1-006DED011A85"
}