AssociateRouteTableWithGateway - Virtual Private Cloud

呼叫 AssociateRouteTableWithGateway 介面將閘道器路由表和同一 VPC 內的 IPv4 閘道器、IPv6 閘道器執行個體繫結。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:AssociateRouteTableWithGateway

create

*Ipv4Gateway

acs:vpc:{#regionId}:{#accountId}:ipv4gateway/{#ipv4gatewayId}

*RouteTable

acs:vpc:{#regionId}:{#accountId}:routetable/{#routetableId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	要繫結的閘道器路由表和 IPv4 閘道器執行個體所在的地域 ID。您可以透過呼叫 DescribeRegions 介面取得地域 ID。	ap-southeast-6
RouteTableId	string	是	要繫結的閘道器路由表 ID。	vtb-5ts0ohchwkp3dydt2****
ClientToken	string	否	用戶端 Token，用於保證請求的冪等性。由用戶端產生該參數值，要保證在不同請求間唯一，最大值不超過 64 個 ASCII 字元。說明若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	否	是否僅預檢此次請求。取值： true：傳送檢查請求，不會關聯閘道器路由表和 IPv4 閘道器執行個體。檢查項目包括是否填寫了必要參數、請求格式、業務限制。如果檢查不通過，則傳回對應錯誤。如果檢查通過，則傳回錯誤碼 `DryRunOperation`。 false（預設值）：傳送正常請求，通過檢查後傳回 HTTP 2xx 狀態碼並直接關聯閘道器路由表和 IPv4 閘道器執行個體。	false
GatewayId	string	是	要關聯的 IPv4 閘道器執行個體 ID。要關聯的 IPv4 閘道器執行個體必須為已啟用狀態。	ipv4gw-5tsnc6s4ogsedtp3k****
GatewayType	string	否	要關聯的閘道器執行個體的類型。	Ipv4Gateway
RegionId	string	是	要綁定的網關路由表和 IPv4 網關執行個體所在的地區 ID。您可以通過調用 DescribeRegions 介面擷取地區 ID。	ap-southeast-6

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	F89C2176-8F10-55EF-90CF-CF99D1E3F816

樣本

正常返回樣本

JSON格式

{
  "RequestId": "F89C2176-8F10-55EF-90CF-CF99D1E3F816"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	ResourceNotFound.Ipv4Gateway	The specified resource ipv4Gateway is not found.	傳入的 IPv4 閘道器執行個體不存在。
400	IncorrectStatus.Ipv4Gateway	The status of %s [%s] is incorrect.	指定的 Ipv4Gateway 處於非穩態，請稍後重試。
400	ResourceAlreadyAssociated.Ipv4Gateway	The specified resource %s is already associated.	指定的 IPv4 閘道器已經被綁定。
400	ResourceNotFound.GatewayRouteTable	The specified resource GatewayRouteTable is not found.	無法找到指定的閘道器路由表。
400	IncorrectStatus.GatewayRouteTable	The status of %s [%s] is incorrect.	指定的閘道器路由表執行個體處於非穩態，請稍後重試。
400	ResourceAlreadyAssociated.GatewayRouteTable	The specified resource %s is already associated.	指定的閘道器路由表已綁定同類型閘道器執行個體。
400	OperationDenied.Ipv4GatewayNotActive	The operation is not allowed because of ipv4Gateway [%s] is not active.	操作不允許，因為指定的 IPv4 閘道器未啟用。
400	OperationDenied.RouteTableTypeIncorrect	The operation is not allowed because of routeTableType is incorrect.	您指定的閘道器路由表執行個體不是邊界閘道器路由表，請檢查您的輸入是否正確。
400	ResourceNotFound.RouteTable	The specified resource gatewayRouteTable is not found.	閘道器路由表不存在。
400	OperationDenied.GatewayAndTableNotInOneVpc	The operation is not allowed because of GatewayAndTableNotInOneVpc.	您指定的閘道器路由表和閘道器執行個體不屬於同一個 VPC，請檢查您的輸入是否正確。
400	IncorrectStatus.RouteTable	The status of the specified route table is incorrect.
400	IllegalParam.GatewayType	The param of %s is illegal.	輸入的 GatewayType 無效。
400	UnsupportedFeature.Ipv6GatewayRouteTable	The feature of %s is not supported.	您指定的閘道器路由表暫不支援綁定該閘道器執行個體。
400	OperationDenied.IngressRoutingNotSupportAnycast	The operation is not allowed because ingress routing not support anycast.	操作失敗，因為指定 VPC 中存在 Anycast 彈性公網 IP。
400	OperationDenied.ExistPublicIpv6IpInVpc	Operation denied because IPV6 public ip exists in VPC.	操作失敗，因為 VPC 中存在 IPv6 公網 IP。
400	ResourceNotFound.Ipv6Gateway	The specified resource of IPv6 Gateway is not found.	傳入的 IPv6 閘道器執行個體不存在。

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

變更歷史

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