调用CreateTransitRouter接口创建企业版转发路由器实例。

API描述

您可以通过调用本接口创建企业版转发路由器实例。当前企业版转发路由器只在部分地域开放,关于地域的详细信息,请参见转发路由器介绍

调试

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

请求参数

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

要执行的操作。取值:CreateTransitRouter

CenId String cen-j3jzhw1zpau2km****

云企业网实例ID。

RegionId String cn-shanghai

企业版转发路由器实例所属地域ID。

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

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

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

TransitRouterName String testname

转发路由器实例的名称。

名称长度为2~128个字符,必须以字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-),但不能以http://https://开头。

TransitRouterDescription String testdesc

转发路由器实例的描述。

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

DryRun Boolean false

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

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

返回数据

名称 类型 示例值 描述
RequestId String 404DA7EC-F495-44B5-B543-6EDCDF90F3D1

请求ID。

TransitRouterId String tr-uf6llz2286805i44g****

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

示例

请求示例

http(s)://[Endpoint]/?Action=CreateTransitRouter
&CenId=cen-j3jzhw1zpau2km****
&RegionId=cn-shanghai
&<公共请求参数>

正常返回示例

XML格式

<CreateTransitRouterResponse>
  <RequestId>404DA7EC-F495-44B5-B543-6EDCDF90F3D1</RequestId>
  <TransitRouterId>tr-uf6llz2286805i44g****</TransitRouterId>
</CreateTransitRouterResponse>

JSON格式

{
  "RequestId": "404DA7EC-F495-44B5-B543-6EDCDF90F3D1",
  "TransitRouterId": "tr-uf6llz2286805i44g****"
}

错误码

HttpCode 错误码 错误信息 描述
400 InstanceExist.TransitRouterInstance The instance already exists. 当前Region下的TransitRouter实例已经存在,不允许同一个Region下重复创建。

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