CreateTransitRouteTableAggregation - 建立彙總路由 -

建立彙總路由。

介面說明

您在企業版轉寄路由器路由表下添加彙總路由後，企業版轉寄路由器僅會向已關聯至當前企業版轉寄路由器路由表，且已開啟路由同步功能的 VPC 執行個體的路由表中傳播彙總路由。

因此在建立彙總路由前，請確保完成以下操作，否則在您添加彙總路由後，企業版轉寄路由器不會向 VPC 執行個體路由表內傳播彙總路由：

VPC 執行個體已經與企業版轉寄路由器路由表建立了關聯轉寄關係。具體操作，請參見 AssociateTransitRouterAttachmentWithRouteTable 。
VPC 執行個體已經開啟路由同步功能。具體操作，請參見 CreateTransitRouterVpcAttachment 。

調試

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

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cen:CreateTransitRouteTableAggregation

create

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
TransitRouteTableId	string	是	企業版轉寄路由器路由表 ID。	vtb-iq8qgruq1ry8jc7vt****
TransitRouteTableAggregationName	string	否	彙總路由的名稱。名稱可以為空白或長度為 1～128 個字元，不能以 http://或 https://開頭。	nametest
TransitRouteTableAggregationCidr	string	是	彙總路由的目標網段。說明不支援添加以下網段：以“0”或者“100.64”開頭的網段組播地址（224.0.0.1~239.255.255.254）	192.168.10.0/24
TransitRouteTableAggregationScope	string	否	彙總路由的傳播範圍。僅取值：VPC，表示向已與當前企業版轉寄路由器路由表建立關聯轉寄關係並已開啟路由同步功能的所有 VPC 執行個體傳播彙總路由。	VPC
TransitRouteTableAggregationScopeList	array	否	彙總路由的傳播範圍列表。說明彙總路由傳播範圍和彙總路由傳播範圍列表必須至少選擇一個屬性，建議使用彙總路由傳播範圍列表；彙總路由傳播範圍列表中元素不能與彙總路由傳播範圍的值重複。
	string	否	彙總路由的傳播範圍列表。取值： VPC，表示向已與當前企業版轉寄路由器路由表建立關聯轉寄關係並已開啟路由同步功能的所有 VPC 執行個體傳播彙總路由。 VBR，表示向已載入到當前企業版轉寄路由器的 VBR 執行個體傳播彙總路由。 Peer，表示向已與當前企業版轉寄路由器建立了跨地區串連的轉寄路由器傳播彙總路由。 VPN，表示向已載入到當前企業版轉寄路由器的 VPN 執行個體傳播彙總路由。 ECR，表示向已載入到當前企業版轉寄路由器的 ECR 執行個體傳播彙總路由。	VPC
TransitRouteTableAggregationDescription	string	否	彙總路由的描述資訊。描述可以為空白或長度為 1～256 個字元，不能以 http://或 https://開頭。	desctest
ClientToken	string	否	用戶端 Token，用於保證請求的等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。說明若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。	02fb3da4-130e-11e9-8e44-001****
DryRun	boolean	否	是否對此次建立請求執行預檢，包括許可權、執行個體狀態校正等。取值： false（預設）：發送正常請求，通過檢查後直接建立彙總路由。 true：發送檢查請求，只進行校正，不會建立彙總路由。檢查項包括是否填寫了必需參數、請求格式等。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼`DryRunOperation`。	false

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50

樣本

正常返回樣本

JSON格式

{
  "RequestId": "0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidOperation.RegionNotSupport	The Operation is not Support in this region.	當前地區不支援該操作。
400	InstanceExist.AggregationRoute	This aggregation route is already created.	彙總路由已經存在。
400	InstanceNotExist.TransitRouteTable	The transitRouter route table is not exist.	TransitRouteTable不存在。
400	IncorrectStatus.TransitRouteTable	The transitRouter route table is not in a valid state for the operation.	當前TransitRouteTable的狀態不支援該操作，請稍後重試。
400	QuotaExceeded.AggregationRoute	The aggregation route count is over limit.	彙總路由數量已達到上限。
400	InstanceNotExist.TransitRouter	The aggregation route is not exist.	transitRouter不存在。
400	OperationUnsupported.TransitRouterType	The operation is not supported because of the wrong transitRouter type.	當前TransitRouter類型不支援該操作。
400	IncorrectStatus.TransitRouter	The status of transitRouter is invalid.	當前TransitRouter的狀態不支援該操作，請稍後重試。
400	OperationUnsupported.ServiceMode	The operation is not supported because of the wrong transitRouter service mode.	當前轉寄路由器模式不支援該操作。
400	InvalidCidrBlock	The cidr block is invalid.	參數中指定的cidrBlock不合法。
400	RouteConflict	The specified route already exists.	輸入的路由已存在。
400	InvalidOperation.InstanceNotSupportIPv6Route	The cen dose not support Ipv6 route.
400	IllegalParam.TransitRouteTableAggregationCidr	The param TransitRouteTableAggregationCidr is illegal.
400	MissingParameter.ScopeListOrScope	The input parameter TransitRouteTableAggregationScopeList or TransitRouteTableAggregationScope that is mandatory for processing this request is not supplied.	TransitRouteTableAggregationScopeList、TransitRouteTableAggregationScope至少填寫一個，推薦使用TransitRouteTableAggregationScopeList。
400	InvalidParameter.TransitRouteTableAggregationScope	TransitRouteTableAggregationScope is invalid.	彙總路由的傳播範圍不合法。
400	InvalidParameter.TransitRouteTableAggregationScopeList	TransitRouteTableAggregationScopeList is invalid.	彙總路由的傳播範圍列表參數設定不合法。
400	MissingParam.TransitRouteTableAggregationScope	The parameter TransitRouteTableAggregationScope is mandatory.	缺失彙總路由的傳播範圍參數。
400	IllegalParam.TransitRouteTableAggregationScope	TransitRouteTableAggregationScope is invalid, valid value is VPC.	彙總路由的傳播範圍非法，合法取值為VPC，請修正後重新發起請求。
400	InvalidParameter	Invalid parameter.	參數不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	帳號無許可權操作。

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

變更歷史

更多資訊，參考變更詳情。