Virtual Private Cloud：CreateRouteEntry

• CreateRouteEntry 介面屬於非同步介面，即系統會回傳一個執行個體 ID，但該路由的新增尚未完成，系統後台的啟動任務仍在進行。您可以呼叫 DescribeRouteEntryList 查詢路由的新增狀態：

  • 當路由處於 Creating 狀態時，表示路由新增中。

  • 當路由處於 Created 狀態時，表示路由新增完成。

• CreateRouteEntry 介面不支援在同一個 VPC 或者同一個 VBR 中併發新增自訂路由條目。

• CreateRouteEntry 介面在併發情況下可能回傳 TaskConflict 錯誤碼，請酌情重試。

使用該介面為 VPC 路由器的路由表新增自訂路由條目時，請注意以下事項：

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

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

• 自訂路由條目的目標網段（DestinationCidrBlock）可以配置為比雲端服務系統路由網段100.64.0.0/10更明細的網段，但不支援與該網段相同。

  重要 由於目標網段為100.64.0.0/10的系統路由用於 VPC 內的雲端產品通訊，建議您謹慎配置更明細的路由，如果配置錯誤將導致雲端產品服務無法正常存取和使用。

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

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

• 多條自訂路由條目可以指向同一個下一跳（NextHopId）。

• 自訂路由條目的下一跳（NextHopId）必須和路由表在同一個 VPC。

• 支援透過 NextHopList 參數配置 ECMP 路由：

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

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

使用該介面為邊界路由器的路由表新增自訂路由條目時，請注意以下事項：

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

• 不支援 NextHopList 參數。

• 自訂路由條目的目標網段（DestinationCidrBlock）可以配置為比雲端服務系統路由網段100.64.0.0/10更明細的網段，但不支援與該網段相同。

  重要 由於目標網段為100.64.0.0/10的系統路由用於 VPC 內的雲端產品通訊，建議您謹慎配置更明細的路由，如果配置錯誤將導致雲端產品服務無法正常存取和使用。

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

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

• 多條自訂路由條目可以指向同一個下一跳（NextHopId）。

• 自訂路由條目的下一跳（NextHopId）必須是該 VBR 關聯的路由器介面。

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

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