CreateRouterInterface_专有网络_API文档-阿里云OpenAPI开发者门户

接口说明

调用本接口创建路由器接口时，请注意：

任意两个路由器之间，最多只能存在一对互连的路由器接口。
一个路由器上可以最多创建 5 个路由器接口。
如果账户下存在欠费状态的路由器接口，则无法再创建路由器接口。
同一路由表下的路由条目的目标网段（DestinationCidrBlock）不允许相同。
边界路由器 VBR（Virtual Border Router）只能是连接发起端，并且是已激活状态。
通过本接口可以创建预付费和后付费的路由器接口。

流控信息

请求速率为300/60(s)。更多流控信息，请前往配额中心查看

授权信息

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

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

vpc:CreateRouterInterface	Create	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VbrId} RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/*	vpc:TargetAccountRDId	无

请求参数

字段名称	字段详情
RegionIdstring	路由器接口所在的地域 ID。展开详情示例值:cn-hangzhou参考取值来源: DescribeRegions
Rolestring	路由器接口的角色，取值：展开详情示例值:InitiatingSide
OppositeRegionIdstring	连接接收端所在的地域 ID。示例值:cn-shanghai
Specstring	路由器接口的规格。可用的规格和对应的带宽取值如下：展开详情示例值:Mini.2
RouterTypestring	路由器接口关联的路由器类型，取值：展开详情示例值:VRouter参考取值来源: DescribeRouterInterfaces
RouterIdstring	路由器接口关联的路由器 ID。示例值:vbr-m5ebm6g9ptc9mly1c****参考取值来源: DescribeVRouters
OppositeInterfaceIdstring	对端路由器接口 ID。示例值:ri-2zeo3xzyf38r4urzd****参考取值来源: DescribeRouterInterfaces
OppositeRouterIdstring	对端路由器的 ID。示例值:vrt-bp1lhl0taikrteen8****参考取值来源: DescribeRouterInterfaces
OppositeRouterTypestring	对端路由器接口关联的路由器类型，取值：展开详情示例值:VRouter参考取值来源: DescribeRouterInterfaces
OppositeInterfaceOwnerIdstring	对端路由器接口的所有者的阿里云账号 ID。示例值:253460731706911258参考取值来源: DescribeRouterInterfaces
HealthCheckSourceIpstring	健康检查源 IP 地址，必须是本端 VPC 内的一个未被使用的 IP。展开详情示例值:192.168.0.6
HealthCheckTargetIpstring	健康检查目的 IP 地址。展开详情示例值:192.168.0.8
AccessPointIdstring	VBR 所属的接入点 ID。展开详情示例值:ap-cn-hangzhou-yh-ts-A参考取值来源: DescribeAccessPoints ListBusinessAccessPoints
OppositeAccessPointIdstring	对端所属的接入点 ID。展开详情示例值:ap-cn-shanghai-nt-aligroup-C
Descriptionstring	路由器接口的描述信息。展开详情示例值:abcabc
Namestring	路由器接口的名称。展开详情示例值:abc
Periodinteger<int32>	购买时长，取值：展开详情示例值:3
InstanceChargeTypestring	路由器接口的付费方式，取值：展开详情示例值:PrePaid
AutoPayboolean	是否自动付费，取值：展开详情示例值:false
PricingCyclestring	预付费的计费周期，取值：展开详情示例值:Month
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:123e4567-e89b-12d3-a456-426655440000
FastLinkModeboolean	是否为使用快速连接模式创建的 VBR 上联路由器接口，快速连接模式可实现 VBR 和 VPC 两端路由器接口创建完毕后自动完成连接。取值：展开详情示例值:false
AutoRenewboolean	是否开通自动续费。取值：展开详情示例值:false
ResourceGroupIdstring	资源组 ID。展开详情示例值:rg-acfmxazb4ph6aiy****
Tagsarray<object>	资源的标签。子级条数 <= 20

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:079874CD-AEC1-43E6-AC03-ADD96B6E4907
OrderIdinteger<int64>	订单号，选择预付费时返回该参数。注意请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。示例值:20210101123456
RouterInterfaceIdstring	路由器接口的 ID。示例值:ri-2ze7fbuohm****

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidPrice.NotFound	Pricing plan result not found.	诊断
400	InvalidAliuid	Invalid Aliuid.	诊断
400	InvalidRole.ValueNotSupported	The specified Role is not valid.	诊断
400	InvalidSpec.ValudNotSupported	The specified Spec is not supported.	诊断
400	InvalidRouterType.ValueNotSupported	The specified RouterType is not valid.	诊断
400	InvalidName.Malformed	The specified "Name" is not valid.	诊断
400	Forbidden.BillsOutstanding	You cannot create more RouterInterface because you have bills outstanding.	诊断
400	LimitationExceed.InterfaceNumberOnRouter	Total number of RouterInterfaces on a Router exceeded.	诊断
400	Forbidden.NotInRouterInterfaceCreateWhitelist	Not in router interface create whitelist.	诊断
400	RI_CREATE_ONE_LIMIT_BY_SYNC	Create ri only one limit by sync.	诊断
400	InvalidAccessPoint.ValueNotAllowed	The non-vbr router interface cannot have access point configured.	诊断
400	InvalidParam.NotFound	Parameter must not be null,uid, bid,regionNo, remoteRegionNo, routerId or accessPointId	诊断
400	InvalidAccessPoint.NotMatch	The accessPoint id is not matched	诊断
400	InvalidAccessPoint.NotExist	The accessPoint not exit	诊断
400	INVAID_VBR_STATUS	VBR status must be active	诊断
400	IncorrectStatus.CenStatus	Cen status must not be middle status.	诊断
400	Forbidden.AcceptRoleNotSupportPrePay	Acception side ri not support chargetype for prepaid.	诊断
400	InvalidRouterInterfaceSpec.Malformed	Specified RouterInterface spec is not valid.	诊断
400	VpcSubnet.NotFound	Vpc subnet not exist.	诊断
400	IllegalParam.HealthcheckIp	Healthcheck ip cannot equal with instance ip.	诊断
400	OperationFailed.HcForInvalidRiType	Healthchecksourceip and healthchecktargetip is only valid for vr ri that is connected to vbr.	诊断
400	OperationFailed.SyncOrderToSub	SyncOrderToSub error.	诊断
400	IllegalParam.CrossBorderBandwidth	CrossBorder bandwidth error.	诊断
400	IllegalParam.VRouterType	The VRouterType is not supported.	诊断
400	IllegalParam.Spec	The spec is illegal.	诊断
400	Forbidden.CrossBorder	User not authorized to create cross border routerInterface.	诊断
400	InvalidRouterId.NotFound	Param is not valid,this user does not have this router or aliuid bid regionNo and routerId must have something wrong.	诊断
400	InvalidCommodity.NotFound	Commodity is not exist.	诊断
400	InvalidRouterInterfaceChargeType.Malformed	Specified RouterInterface ChargeType is not valid.	诊断
400	IllegalParam.RegionId	The specified regionId is illegal.	诊断
400	PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL	User withhoding argeement is illegal.	诊断
400	QuotaExceeded	RiPerUser quota exceeded	诊断
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	诊断
400	InvalidRegionId.NotFound	The regionId provided does not exist in ec region list.	诊断
400	ResourceNotInResourceGroup	The specified resource is not in the specified ResourceGroup.	诊断
400	HaveConnectionBetweenRouters	Have connection between routers	诊断
400	InvalidDescription.Malformed	The specified "Description" is not valid.	诊断
400	InvalidBandwidth.NotEnough	Bandwidth not enough.	诊断
400	ForbiddenAction	The user does not support this action.	诊断
400	OperationFailed.NotSupportIPv6	Router interface not support IPv6.	诊断
400	InvalidParam.AvailableZoneId	The specified AvailableZoneId did not retrieve the corresponding cluster IP address.	诊断
400	OperationFailed.NoAvailableAmount	The available amount of your account is less than 0, please recharge before attempting to purchase.	诊断
400	OperationFailed.OperationLocked	Operation failed because OperationLocked.	诊断
400	OperationFailed.InvalidEcGrant	The VBR have no grant to create EC.	诊断
400	OperationFailed.CannotConnectOtherOwnerInstance	Can not connect with other owner VPC or CEN.	诊断
404	InvalidRegionId.NotFound	The regionId provided does not exist in our records.	诊断
404	InvalidRouterId.NotFound	The specified RouterId does not exist in our recored.	诊断
404	InvalidRouterId.AttacedToCEN	Can not create ri when attaced to CEN.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-03-19	变更错误码400
	2024-06-28	变更错误码400
	2024-05-08	变更错误码400
	2024-04-17	变更错误码400
	2023-12-22	变更错误码400
	2023-12-21	变更错误码400
	2023-09-11	变更错误码400
	2023-07-20	变更错误码400 新增请求参数ResourceGroupId 新增请求参数Tags
	2023-05-18	新增请求参数AutoRenew
	2022-12-05	新增请求参数FastLinkMode

1
2
10 条/页

CreateRouterInterface_专有网络_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例