调用CreateTransitRouterVbrAttachment接口在企业版转发路由器下创建边界路由器VBR(Virtual border router)连接。

API描述

您可以通过以下两种方式在企业版转发路由器下创建VBR连接:

  • 如果您已经在目标地域创建了企业版转发路由器实例,您可以通过指定VbrIdTransitRouterId创建VBR连接。
  • 如果您在目标地域没有企业版转发路由器实例,您可以通过指定VbrIdCenIdRegionId创建VBR连接。创建VBR连接时系统为您自动创建企业版转发路由器实例。

使用限制

企业版转发路由器仅在部分地域开放,您只能在企业版转发路由器支持的地域创建VBR连接。关于企业版转发路由器支持的地域和可用区信息,请参见转发路由器介绍

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateTransitRouterVbrAttachment

要执行的操作。取值:CreateTransitRouterVbrAttachment

VbrId String vbr-bp1svadp4lq38janc****

VBR实例ID。

ClientToken String 02fb3da4-130e-11e9-8e44-001****

客户端Token,用于保证请求的幂等性。

由客户端生成该参数值,需保证该参数在不同请求间唯一,最大值不超过64个ASCII字符。

CenId String cen-j3jzhw1zpau2km****

云企业网实例ID。

TransitRouterId String tr-bp1su1ytdxtataupl****

企业版转发路由器实例ID。

RegionId String cn-hangzhou

VBR实例所属地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

TransitRouterAttachmentName String testname

VBR连接名称。

名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、下划线(_)或短划线(-)。

TransitRouterAttachmentDescription String testdesc

VBR连接描述。

描述长度为2~256个字符,必须以字母或中文开头,但不能以http://https://开头。

VbrOwnerId Long 1688111111111111

VBR实例所属阿里云账号(主账号)ID。默认值为当前登录的阿里云账号ID。

说明 如果您要加载跨账号的网络实例,本参数必填。
AutoPublishRouteEnabled Boolean false

是否使企业版转发路由器自动发布路由到VBR实例。

  • false(默认值):否。
  • true:是。
DryRun Boolean false

是否对此次请求执行预检,包括权限、实例状态校验等。取值:

  • false(默认值):发送正常请求,通过检查后直接创建VBR连接。
  • true:发送检查请求,只进行校验,不会创建VBR连接。检查项包括是否填写了必需参数、请求格式等。如果检查不通过,则返回对应错误。如果检查通过,则返回对应请求ID。

返回数据

名称 类型 示例值 描述
RequestId String C087A369-82B9-43EF-91F4-4B63A9C6E6B6

请求ID。

TransitRouterAttachmentId String tr-attach-ia340z7xis7t5s****

VBR连接ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateTransitRouterVbrAttachment
&VbrId=vbr-bp1svadp4lq38janc****
&<公共请求参数>

正常返回示例

XML格式

<CreateTransitRouterVbrAttachmentResponse> 
  <TransitRouterAttachmentId>tr-attach-ia340z7xis7t5s****</TransitRouterAttachmentId>
  <RequestId>C087A369-82B9-43EF-91F4-4B63A9C6E6B6</RequestId>
</CreateTransitRouterVbrAttachmentResponse>

JSON格式

{
  "TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****",
  "RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6"
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission.AliyunServiceRolePolicyForCEN You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. 您没有权限创建服务关联角色,角色名:AliyunServiceRolePolicyForCEN,服务名:cen.aliyuncs.com。请确保已授予当前用户ram:CreateServiceLinkedRole权限。
400 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation. 中转地域不支持此操作。
400 InvalidCenId.NotFound CenId is not found. CEN实例不存在。

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