AssociateRouteTablesWithVpcGatewayEndpoint_专有网络_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

在调用本接口关联路由表与网关终端节点时,请了解以下内容:

  • 要关联路由表的网关终端节点实例不能处于 Creating(创建中)、Modifying(修改中)、Associating(绑定中)、Dissociating(解绑中)、Deleting(删除中)等中间状态。
  • 要关联的路由表不能处于 Creating(创建中)、Modifying(修改中)、Associating(绑定中)、Dissociating(解绑中)、Deleting(删除中)等中间状态。
  • 要关联的路由表和网关终端节点必须属于同一个 VPC。
  • 要关联的路由表不能是被共享的。
  • 不支持关联 VBR 路由表。
  • 一次最多关联 20 张路由表。
  • AssociateRouteTablesWithVpcGatewayEndpoint 接口属于异步接口,即系统返回一个实例 ID,但该路由表与网关终端节点尚未绑定成功,系统后台的绑定任务仍在进行。您可以调用 GetVpcGatewayEndpointAttribute 查询路由表与网关终端节点的绑定状态:
    • 当路由表与网关终端节点处于 Associating 状态时,表示路由表与网关终端节点正在绑定中。
    • 当路由表与网关终端节点处于 Created 状态时,表示路由表与网关终端节点绑定成功。
  • AssociateRouteTablesWithVpcGatewayEndpoint 接口不支持并发关联同一个路由表与网关终端节点。

流控信息

请求速率为600/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
vpc:AssociateRouteTablesWithVpcGatewayEndpoint
Create
GatewayEndpoint
acs:vpc:{#regionId}:{#accountId}:gatewayendpoint/{#GatewayEndpointId}

请求参数

字段名称字段详情
EndpointIdstring

要关联路由表的网关终端节点实例 ID。

示例值:vpce-m5e371h5clm3uadih****参考取值来源:
    ListVpcGatewayEndpoints
    CreateVpcGatewayEndpoint
RouteTableIdsarray<string>

要关联的路由表 ID。N 的取值范围为 1~20,即一次最多绑定 20 张路由表。

示例值:vtb-m5elgtm3aj586iitr****子级条数 <= 20
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。展开详情

示例值:5A2CFF0E-5718-45B5-9D4D-70B3FF3898
DryRunboolean

是否只预检此次请求,取值:展开详情

示例值:false
RegionIdstring

要关联路由表的网关终端节点的地域 ID。展开详情

示例值:cn-hangzhou参考取值来源:
    DescribeRegions

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:59BDDA2D-FB52-59F9-9DC5-5EA7D6808B8E

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
OperationFailed.ConcurrentOperation
The operation is failed because of concurrent operation.诊断
400
IdempotentParameterMismatch
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.诊断
400
ResourceNotFound.GatewayEndpoint
The specified resource gateway endpoint is not found.诊断
400
IncorrectStatus.GatewayEndpoint
The status of GatewayEndpoint [%s] is incorrect.诊断
400
ResourceNotFound.ServiceName
The specified resource service name is not found.诊断
400
ResourceNotFound.PrefixList
The specified resource prefixList is not found.诊断
400
ResourceNotFound.RouteTable
The specified resource routetable is not found.诊断
400
Mismatch.VpcAndRouteTable
The vpc and routetable are mismatched.诊断
400
IncorrectStatus.RouteTable
The status of route table [%s] is incorrect.诊断
400
ResourceAlreadyExist.Association
The specified resource of [%s] is already exist.诊断
400
VPC_ROUTE_ENTRY_CIDR_BLOCK_DUPLICATE
Specified CIDR block is already exists.诊断
400
VPC_SWITCH_STATUS_ERROR
vSwitch status error, %s诊断
400
QuotaExceeded.VpcRouteEntryNum
The quota of vpc route entry num is exceeded, usage %s/%s.诊断
400
OperationUnsupported.DestinationCidrBlockOverlapWithVSwitch
The operation is failed because of destination CIDR block is in the CIDR of the VSwitch.诊断
400
SystemBusy
System is busy, please try again later.诊断
400
Forbbiden
User not authorized to operate on the specified resource.诊断
400
InvalidRegionId.NotFound
The regionId provided does not exist in our records.诊断
400
IncorrectStatus.Vpc
The status of vpc [%s] is incorrect.诊断
400
IncorrectStatus.CenStatus
The status of vpc cenStatus [%s] is incorrect.诊断
400
UnsupportedFeature.RouterTableType
The type of router table is not supported.诊断

变更历史

变更时间变更内容概要操作
2023-12-07
变更错误码400

相关示例

创建路由表 --> 创建网关终端节点 --> 修改终端节点的policy --> 绑定终端节点和两个路由表 --> 查询绑定关系为Associated
2021-12-17