CreateRouterInterface --云服务器 ECS(ECS)-阿里云帮助中心

说明

目前该API接口已标记为弃用，推荐使用替代API：Vpc(2016-04-28) - CreateRouterInterface。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

vpc:CreateRouterInterface

create

*全部资源

*

vpc:TargetAccountRDId

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是
Role	string	是
OppositeRegionId	string	是
Spec	string	是
RouterType	string	是
RouterId	string	是
OppositeInterfaceId	string	否
OppositeRouterId	string	否
OppositeRouterType	string	否
OppositeInterfaceOwnerId	string	否
HealthCheckSourceIp	string	否
HealthCheckTargetIp	string	否
AccessPointId	string	否
OppositeAccessPointId	string	否
Description	string	否
Name	string	否
Period	integer	否
InstanceChargeType	string	否
AutoPay	boolean	否
PricingCycle	string	否
ClientToken	string	否
ClientToken	string	否
UserCidr	string	否

返回参数

名称	类型	描述	示例值
	object
RequestId	string
OrderId	integer
RouterInterfaceId	string

示例

正常返回示例

JSON格式

{
  "RequestId": "",
  "OrderId": 0,
  "RouterInterfaceId": ""
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidPrice.NotFound	Pricing plan result not found.
400	InvalidAliuid	Invalid Aliuid.
400	InvalidBandwidth.NotEnough	bandwdith not enough.
400	InvalidRole.ValueNotSupported	The specified Role is not valid.	指定的 Role 不合法，请您检查该参数是否正确。
400	InvalidSpec.ValudNotSupported	The specified Spec is not supported.	不支持指定的 Spec。
400	InvalidRouterType.ValueNotSupported	The specified RouterType is not valid.	指定的路由器类型不合法。
400	InvalidOppositeRouterType.ValueNotSupported	The specified OppositeRouterType is not valid.	指定的 OppositeRouterType 不合法。
400	ParameterMismatch.Role-Spec	The specified Spec and Role mismatch.	指定的技术规格与角色不符。
400	InvalidName.Malformed	The specified "Name" is not valid.
400	InvalidDescription.Malformed	The specifid "Description" is not valid.
400	Forbidden.BillsOutstanding	You cannot create more RouterInterface because you have bills outstanding.	存在未付款订单，导致新建路由器接口失败，请您先付费后再进行操作。
400	QuotaExceed.RouterInterface	Living RouterInterface quota exceeded.	活跃的路由器接口已达上限。
400	LimitationExceed.InterfaceNumberOnRouter	Total number of RouterInterfaces on a Router exceeded.	路由器接口总数超过限制。
400	InvalidParam.NotFound	Parameter must not be null,uid, bid,regionNo, remoteRegionNo or routerId
400	InvalidAccessPoint.NotMatch	The accessPoint id is not matched	指定的访问点 ID 不匹配。
400	InvalidAccessPoint.NotExist	The accessPoint not exit
400	ForbiddenAction	The user does not supported this action.
400	Forbidden.AcceptRoleNotSupportPrePay	Acception side ri not support chargetype for prepaid.
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	INVAID_VBR_STATUS	VBR status must be active
400	InvalidRouterInterfaceSpec.Malformed	Specified RouterInterface spec is not valid.
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.
500	Forbidden.NotInRouterInterfaceCreateWhitelist	Not in router interface create whitelist.
500	RI_CREATE_ONE_LIMIT_BY_SYNC	Create ri only one limit by sync.
500	InvalidDescription.Malformed	The specifid "Description" is not valid.
500	InvalidName.Malformed	The specified "Name" is not valid.
500	InvalidAccessPoint.ValueNotAllowed	The non-vbr router interface cannot have access point configured.
404	InvalidRegionId.NotFound	The regionId provided does not exist in our records.	提供的RegionId不存在
404	InvalidOppositeRegionId.NotFound	The oppositeRegionId provided does not exist in our records.
404	InvalidRouterId.NotFound	The specified RouterId does not exist in our recored.	指定的 RouterId 不存在。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。