调用CreateTransitRouterVpcAttachment接口在企业版转发路由器下创建专有网络VPC(Virtual Private Cloud)连接。

前提条件

在您调用本接口创建VPC连接前,请确保满足以下条件:

  • VPC实例下至少包含两台交换机且分布在不同可用区。关于企业版转发路由器支持的地域和可用区信息,请参见转发路由器介绍
  • 如果您要连接跨账号的网络实例,请先获得跨账号网络实例授权。具体操作,请参见跨账号网络实例授权
  • VPC连接创建后会产生费用,请确保您已经了解相关计费规则。更多信息,请参见转发路由器计费说明

API描述

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

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

调试

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

请求参数

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

要执行的操作。取值:CreateTransitRouterVpcAttachment

VpcId String vpc-bp1kbjcre9vtsebo1****

VPC实例ID。

ZoneMappings.N.VSwitchId String vsw-bp1a214sbus8z3b54****

请分别在企业版转发路由器的主备可用区中选择一个交换机实例。N的最大值为2

ZoneMappings.N.ZoneId String cn-hangzhou-h

企业版转发路由器的主可用区和备可用区。N的最大值为2

您可以通过DescribeZones接口查询可用区的ID。

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

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

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

CenId String cen-j3jzhw1zpau2km****

云企业网实例ID。

TransitRouterId String tr-bp1su1ytdxtataupl****

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

RegionId String cn-shanghai

VPC实例所属地域ID。

TransitRouterAttachmentName String testname

VPC连接的名称。

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

TransitRouterAttachmentDescription String testname

VPC连接的描述信息。

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

VpcOwnerId Long 1688111111111111

VPC实例所属账号ID。默认值为当前登录账号ID。

ChargeType String POSTPAY

付费方式。默认值:POSTPAY,表示按量付费。

DryRun Boolean false

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

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

返回数据

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

请求ID。

TransitRouterAttachmentId String tr-attach-ia340z7xis7t5s****

VPC连接ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateTransitRouterVpcAttachment
&VpcId=vpc-bp1kbjcre9vtsebo1****
&ZoneMappings.1.VSwitchId=vsw-bp1a214sbus8z3b54****
&ZoneMappings.1.ZoneId=cn-hangzhou-h
&<公共请求参数>

正常返回示例

XML格式

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

JSON格式

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

错误码

HttpCode 错误码 错误信息 描述
400 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation. 中转地域不支持此操作。
400 NoPermission.AliyunServiceRoleForCEN You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. 您没有权限创建服务关联角色,角色名:AliyunServiceRoleForCEN,服务名:ServiceName:cen.aliyuncs.com。请确保已授予当前用户ram:CreateServiceLinkedRole权限。
400 MissingParam.CenIdOrRegionId Either CenId or RegionId must be specified. CenId或者RegionId是必选参数。

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