全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
专有网络 VPC

CreateRouterInterface

更新时间:2018-04-09 22:25:36

描述

创建路由器接口。

调用本接口创建路由器接口时,请注意:

  • 任意两个路由器之间,最多只能存在一对互连的路由器接口。

  • 一个路由器上可以最多创建5个路由器接口。

  • 如果账户下存在欠费状态的路由器接口,则无法创建更多的路由器接口。

  • VBR上的路由器接口只能是连接发起端。

  • 在只能在处于Active状态VBR上创建路由器接口。

说明: 使用API创建的路由器接口只支持按天计费,不支持包年包月的计费方式。如果您要购买包年包月的路由器接口,请参见创建路由器接口

请求参数

名称 类型 是否必须 描述
Action String 接口名,系统规定参数。

取值:CreateRouterInterface

RegionId String 路由器接口所在的地域。

您可以通过调用DescribeRegions接口查询地域ID。

RouterType String 路由器接口所属的路由器类型。取值:

  • VRouter:VPC路由器
  • VBR:边界路由器
AccessPointId String VBR所属的接入点ID。物理专线接入场景下需指定该参数。
RouterId String 路由器接口所属的路由器ID。
Role String 路由器接口的角色,取值:

  • InitiatingSide:连接发起端
  • AcceptingSide:连接接收端
Spec String 路由器接口的规格。可用的规格和对应的带宽如下:
  • Mini.2: 2 Mbps

  • Mini.5: 5 Mbps

  • Small.1: 10 Mbps

  • Small.2: 20 Mbps

  • Small.5: 50 Mbps

  • Middle.1: 100 Mbps

  • Middle.2: 200 Mbps

  • Middle.5: 500 Mbps

  • Large.1: 1000 Mbps

  • Large.2: 2000 Mbps

  • Large.5: 5000 Mbps

  • Xlarge.1: 10000 Mbps

OppositeRegionId String 连接接收端所在的地域。
OppositeAccessPointId String 对端所属的接入点ID。对端路由器接口位于VBR上时需指定该参数,创建路由器接口后无法修改。
OppositeRouterType String 对端路由器接口所属的路由器类型。取值:

  • VRouter(默认值):VPC路由器
  • VBR:边界路由器。
OppositeRouterId String 对端的路由器的ID。
OppositeInterfaceId String 对端路由器接口的ID。
OppositeInterfaceOwnerId String 对端路由器接口的持有者账号的UID。
Name String 路由器接口的名称,默认值为路由器接口的ID。

长度为 [2, 128] 个英文或中文字符,必须以大小字母或中文开头,可包含数字,下划线(_)和短横线(-)不能以“http://” 或 “https://” 开头。

Description String 路由器接口的的描述信息,默认值为空。

长度为 [2, 256] 个英文或中文字符,不能以“http://” 或“https://” 开头。

HealthCheckSourceIp String 健康检查源IP地址。物理专线接入场景下需指定该参数。

必须是本端VPC内的一个未被使用的IP。

HealthCheckTargetIp String 健康检查目的IP地址。物理专线接入场景下需指定该参数。

HealthCheckSourceIp与HealthCheckTargetIp必须同时指定或同时不指定。

InstanceChargeType String 路由器接口的付费方式。取值:

  • PrePaid:预付费
  • PostPaid(默认值):后付费
选择预付费后,返回参数中会有一个订单号,请到订单中心完成支付。
PricingCycle String 预付费的计费周期,选择预付费时该参数为必选参数。取值:

  • Month(默认值):按月付费
  • Year:按年付费
Period String 预付费的付费时长,选择预付费时该参数为必选参数。取值范围:

  • 当选择按月付费时,取值范围为 [1, 9]
  • 当选择按年付费时,取值范围为 [1, 3]

AutoPay String 选择是否自动支付,当选择预付费时该参数生效,取值:

  • true:自动支付订单。
  • false(默认值):不自动支付,生成订单后需要到订单中心完成支付。
ClientToken String

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个ASCII字符。

详情参见如何保证幂等性

返回参数

名称 类型 描述
RequestId String 请求ID。
RouterInterfaceId String 路由器接口的实例ID。
OrderId String 订单号,选择预付费时返回该参数。

错误码

关于本接口的错误码的详细解释,请参见VPC API错误中心

示例

请求示例

  1. http://vpc.aliyuncs.com/?Action=CreateRouterInterface
  2. &Role=InitiatingSide
  3. &OppositeRegionId=cn-hangzhou
  4. &Spec=Middle.1
  5. &RouterType=VRouter
  6. &RouterId=
  7. &RegionId=cn-beijing
  8. &<公共请求参数>

返回示例

JSON格式

  1. {
  2. "RequestId": "C4C873E5-8B92-4CD8-9163-66703A808E46",
  3. "RouterInterfaceId": "ri-2ze7fbuohmxxxxxx"
  4. }
本文导读目录