文档首页> 虚拟私有云 VPC> API参考> API> 路由表> 关联路由表与子网
更新时间:2022-02-14 GMT+08:00
分享

关联路由表与子网

功能介绍

路由表关联子网。

子网关联路由表A后,再关联路由表B,不需要先跟路由表A解关联,即可关联路由表B。

调试

您可以在API Explorer中调试该接口。

URI

POST /v1/{project_id}/routetables/{routetable_id}/action

参数说明请参见表1

表1 参数说明

名称

是否必选

参数类型

说明

project_id

String

项目ID,请参见获取项目ID

routetable_id

String

路由表ID,路由表唯一标识

请求消息

  • 请求参数
    表2 请求参数

    名称

    是否必选

    参数类型

    说明

    routetable

    routetable object

    路由表对象,参见表3

    表3 routetable字段说明

    名称

    是否必选

    参数类型

    说明

    subnets

    Array of subnet objects

    • 功能说明:路由表所关联的子网。
    • 约束:只能关联路由表所属vpc下的子网
    表4 subnet字段说明

    名称

    是否必选

    参数类型

    说明

    associate

    Array of strings

    路由表关联子网ID列表

    disassociate

    Array of strings

    路由表解除关联子网ID列表

  • 请求样例
    POST https://{Endpoint}/v1/6fbe9263116a4b68818cf1edce16bc4f/routetables/3d42a0d4-a980-4613-ae76-a2cddecff054/action
    
    {
        "routetable": {
            "subnets": {
                "associate": [
                    "1a8b8c98-3976-401b-a735-8b058109268c"
                ]
            }
        }
    }

响应消息

  • 响应参数
    表5 响应参数

    名称

    参数类型

    说明

    routetable

    routetable object

    路由表对象,参见表6

    表6 routetable字段说明

    名称

    参数类型

    说明

    id

    String

    • 功能说明:路由表唯一标识
    • 取值范围:标准UUID

    name

    String

    • 功能说明:路由表名称
    • 取值范围:0-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)

    default

    Boolean

    • 功能说明:是否为默认路由表
    • 取值范围:true表示默认路由表;false表示自定义路由表

    routes

    Array of route objects

    • 功能说明:路由对象列表,参见表4
    • 约束:每个路由表最大关联200条路由

    subnets

    Array of subnet objects

    • 功能说明:路由表所关联的子网,参见表5
    • 约束:只能关联路由表所属VPC下的子网

    tenant_id

    String

    • 功能说明:项目ID

    vpc_id

    String

    • 功能说明:路由表所属VPC的ID

    description

    String

    • 路由表的描述信息
    • 取值范围:0-255个字符,不能包含“<”和“>”
    表7 route字段说明

    名称

    参数类型

    说明

    type

    String

    • 功能说明:路由的类型
    • 取值范围:
      • ecs:弹性云服务器
      • eni:网卡
      • vip:虚拟IP
      • nat:NAT网关
      • peering:对等连接
      • vpn:虚拟专用网络
      • dc:云专线
      • cc:云连接
      • egw:VPC终端节点

    destination

    String

    • 功能说明:路由目的网段
    • 约束:合法的CIDR格式

    nexthop

    String

    • 功能说明:路由下一跳对象的ID
    • 取值范围:
      • 当type为ecs时,传入ecs实例ID
      • 当type为eni时,取值为从网卡ID
      • 当type为vip时,取值为vip对应的IP地址
      • 当type为nat时,取值为nat实例对应的ID
      • 当type为peering时,取值为peering对应实例ID
      • 当type为vpn时,取值为vpn实例ID
      • 当type为dc时,取值为dc实例ID
      • 当type为cc时,取值为cc的实例ID
      • 当type为egw时,取值为vpc终端节点的实例ID

    description

    String

    • 功能说明:路由的描述信息
    • 取值范围:0-255个字符,不能包含“<”和“>”
    表8 subnet字段说明

    名称

    参数类型

    说明

    id

    String

    路由表关联的子网ID

  • 响应样例
    {
        "routetable": {
            "id": "3d42a0d4-a980-4613-ae76-a2cddecff054",
            "vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff",
            "description": "abc",
            "routes": [
                {
                    "type": "ecs",
                    "destination": "10.10.10.0/24",
                    "nexthop": "7c50463d-d36c-4417-aa85-cc11fa10f341",
                    "description": "abc"
                }
            ],
            "subnets": [
                {
                    "id": "8d4ce32f-d68a-4c4c-9f18-c68d8a5c7f2f"
                }
            ],
            "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f"
        }
    }

状态码

请参见状态码

错误码

请参考错误码

分享:

    相关文档

    相关产品

close