文档首页/ 企业路由器 ER/ API参考（安卡拉区域）/ API/ 路由表/ 创建路由表
更新时间：2024-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建路由表

功能介绍

路由表是企业路由器收发报文的依据，包含了连接的关联关系，传播关系以及路由信息。

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/enterprise-router/{er_id}/route-tables

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

er_id

是

String

企业路由器实例ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Client-Token

否

String

幂等性标识

最小长度：1

最大长度：64
表3 请求Body参数

参数

是否必选

参数类型

描述

route_table

否

CreateRouteTable object

路由表
表4 CreateRouteTable

参数

是否必选

参数类型

描述

name

是

String

路由器表名称，取值范围：1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）

最小长度：1

最大长度：64

description

否

String

路由器表描述信息

最小长度：0

最大长度：255

tags

否

Array of Tag objects

标签信息
表5 Tag

参数

是否必选

参数类型

描述

key

否

String

标签键，规则：

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线“_”，点“.”，冒号“:”，等号“=”，加号“+”，中划线“-”，“@”。

  • _sys_开头属于系统标签，租户不能输入。

  • 标签key不能为空（长度不能为0）。

  • 长度在1-128之间。

最小长度：1

最大长度：128

value

否

String

标签值，规则：

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线“_”，点“.”，冒号“:”，等号“=”，加号“+”，中划线“-”，“@”。

  • 资源标签值可以为空（empty or null）。

  • 长度在0-255之间。

最小长度：0

最大长度：255

响应参数

状态码： 202

表6 响应Header参数

参数

参数类型

描述

X-Client-Token

String

幂等性标识
表7 响应Body参数

参数

参数类型

描述

route_table

RouteTable object

路由表

request_id

String

请求ID
表8 RouteTable

参数

参数类型

描述

id

String

路由表的id

name

String

路由表名字

description

String

描述信息

is_default_association

Boolean

是否为默认关联的路由表

缺省值：false

is_default_propagation

Boolean

是否为默认传递路由表

state

String

路由表状态，支持的状态有pending | available | deleting | deleted | failed

tags

Array of Tag objects

标签

created_at

String

创建时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ

updated_at

String

更新时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ
表9 Tag

参数

参数类型

描述

key

String

标签键，规则：

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线“_”，点“.”，冒号“:”，等号“=”，加号“+”，中划线“-”，“@”。

  • _sys_开头属于系统标签，租户不能输入。

  • 标签key不能为空（长度不能为0）。

  • 长度在1-128之间。

最小长度：1

最大长度：128

value

String

标签值，规则：

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及字符：下划线“_”，点“.”，冒号“:”，等号“=”，加号“+”，中划线“-”，“@”。

  • 资源标签值可以为空（empty or null）。

  • 长度在0-255之间。

最小长度：0

最大长度：255

请求示例

在企业路由器内创建路由表，名称为“my-route-table”

POST https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/915a14a6-867b-4af7-83d1-70efceb146f0/route-tables

{
  "route_table" : {
    "name" : "my-route-table",
    "tags" : [ {
      "key" : "key",
      "value" : "value"
    } ]
  }
}

响应示例

状态码： 202

Accepted

{
  "route_table" : {
    "id" : "4ab54142-7c92-48ad-8288-77727a231052",
    "name" : "my-route-table",
    "is_default_association" : false,
    "is_default_propagation" : false,
    "state" : "pending",
    "created_at" : "2020-03-11T15:13:31Z",
    "updated_at" : "2020-03-11T15:13:31Z",
    "tags" : [ {
      "key" : "key",
      "value" : "value"
    } ]
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

状态码

状态码

描述

202

Accepted

错误码

请参见错误码。

父主题： 路由表