全部產品
Search
文件中心

Virtual Private Cloud:CreateRouteTable - 建立自訂路由表

更新時間:Apr 27, 2026

建立自訂路由表。

介面說明

  • CreateRouteTable 介面屬於非同步介面,即系統會返回一個執行個體 ID,但該自訂路由表尚未建立完成,系統背景建立任務仍在進行。您可以調用 DescribeRouteTableList 查詢自訂路由表的建立狀態:
    • 當自訂路由表處於 Creating 狀態時,表示自訂路由表建立中。

    • 當自訂路由表處於 Available 狀態時,表示自訂路由表建立完成。

  • CreateRouteTable 介面不支援在同一個 VPC 中並發建立自訂路由表。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

路由表所屬的 VPC 的地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-zhangjiakou

VpcId

string

自訂路由表所屬的 VPC ID。

vpc-bp1qpo0kug3a20qqe****

RouteTableName

string

路由表的名稱。

名稱長度為 1~128 個字元,不能以http://https://開頭。

myRouteTable

Description

string

路由表的描述資訊。

描述長度為 1~256 個字元,不能以http://https://開頭。

abc

AssociateType

string

建立的路由表的類型。取值:

  • VSwitch(預設值):交換器路由表。

  • Gateway:網關路由表。

VSwitch

RegionId

string

路由表所屬的 VPC 的地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-zhangjiakou

ClientToken

string

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

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

02fb3da4-130e-11e9-8e44-0016e04

Tag

array<object>

資源的標籤。

object

標籤。

Key

string

資源的標籤鍵。最多支援輸入 20 個標籤鍵。如需傳入該值,則不能輸入Null 字元串。

一個標籤鍵最多支援 128 個字元,不能以aliyunacs:開頭,不能包含http://或者https://

FinanceDept

Value

string

資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值,可以輸入Null 字元串。

最多支援 128 個字元,不能以aliyunacs:開頭,不能包含http://或者https://

FinanceJoshua

返回參數

名稱

類型

描述

樣本值

object

路由表的詳細資料。

RequestId

string

請求 ID。

62172DD5-6BAC-45DF-8D44-E11ED28DCAC0

RouteTableId

string

路由表 ID。

vtb-bp145q7glnuzdvzu2****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "62172DD5-6BAC-45DF-8D44-E11ED28DCAC0",
  "RouteTableId": "vtb-bp145q7glnuzdvzu2****"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 UnsupportedRegion The feature of ipv4Gateway is not supported in the region. 該地區不支援ipv4網關
400 InvalidParameter.RouteTableName.Malformed The specified route table name is not valid.
400 InvalidParameter.Description.Malformed The specified Description is not valid.
400 QuotaExceeded.RouteTable VPC RouteTable quota exceeded. 超過VPC RouteTable配額。
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation. CBN目前狀態不正確
400 InvalidVpcId.NotSupport The vpc is not support.
400 OperationUnsupported.AdvancedFeature Advanced features of the vpc is unsupported. 不支援該進階特性。
400 QuotaExceeded.GatewayRouteTable The quota of Gateway Route Table is exceeded. 單VPC建立網關路由表Quota已達上限。
400 MissingParam.vpcId The parameter vpcId is mandatory. 參數缺失,vpcId是必選參數
400 InvalidRegionId.NotFound Specified value of RegionId is not supported.
400 InvalidParameter.Action This vpc feature is not supported in this region
404 InvalidVpcId.NotFound Specified VPC does not exist.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情