本文导读

功能介绍
调用方法
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 企业路由器 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

错误码

请参见错误码。

父主题： 路由表

上一篇：路由表

下一篇：更新路由表信息

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消