All Products
Search

This Product

    Virtual Private Cloud:DescribeRouteTableList

    Document Center

    Virtual Private Cloud:DescribeRouteTableList

    Last Updated:Aug 28, 2026

    Queries route tables.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RouterType

    string

    No

    The type of router to which the route table belongs. Valid values:

    • VRouter (default): a vRouter

    • VBR: a VBR

    VRouter
    RouterId

    string

    No

    The ID of the vRouter to which the route table belongs.

    vrt-bp1lhl0taikrteen8****
    VpcId

    string

    No

    The ID of the VPC to which the route table belongs.

    If set, RouterType is automatically set to VRouter.

    vpc-bp15zckdt37pq72****
    RouteTableId

    string

    No

    The ID of the route table.

    vtb-bp145q7glnuzdvzu2****
    RouteTableName

    string

    No

    The name of the route table.

    doctest
    PageNumber

    integer

    No

    The page number. Default value: 1.

    1
    PageSize

    integer

    No

    The number of entries per page. Maximum: 50. Default: 10.

    10
    ResourceGroupId

    string

    No

    The ID of the resource group to which the route table belongs.

    rg-acfmxazb4ph****
    RegionId

    string

    Yes

    The region ID of the VPC to which the route table belongs.

    Call DescribeRegions to query the most recent region list.

    ap-southeast-6
    Tag

    array<object>

    No

    The tags of the resource.

    object

    No

    The tags of the resource.

    Key

    string

    No

    The value of tag N to add to the resource. You can specify up to 20 tag values. The tag value can be an empty string.

    The tag value can be up to 128 characters in length. It cannot start with aliyun or acs: and cannot contain http:// or https://.

    FinanceDept
    Value

    string

    No

    The value of tag N to add to the resource. You can specify up to 20 tag values. The tag value can be an empty string.

    The tag value can be up to 128 characters in length. It cannot start with aliyun or acs: and cannot contain http:// or https://.

    FinanceJoshua
    RouteTableType

    string

    No

    The type of the route table.

    • System

    • Custom

    System

    Response elements

    Element

    Type

    Description

    Example

    object

    The details of the route table.

    RequestId

    string

    The request ID.

    DC668356-BCB4-42FD-9BC3-FA2B2E04B634
    PageSize

    integer

    The number of entries per page.

    10
    PageNumber

    integer

    The page number.

    1
    TotalCount

    integer

    The total number of entries returned.

    1
    RouterTableList

    object

    RouterTableListType

    array<object>

    The detailed information about the route tables.

    array<object>

    The details of the route table.

    VpcId

    string

    The ID of the VPC to which the route table belongs.

    vpc-bp15zckdt37pq72****
    CreationTime

    string

    The time when the route table was created.

    2021-08-22T10:40:25Z
    Status

    string

    The status of the route table. Valid values:

    • Pending

    • Available

    • Deleting

    Available
    RouterId

    string

    The ID of the vRouter to which the route table belongs.

    vrt-bp1lhl0taikrteen8****
    AssociateType

    string

    The type of cloud resource associated with the route table. Valid values:

    • vSwitch: vSwitch

    • Gateway: IPv4 gateway

    vSwitch
    RouteTableId

    string

    The ID of the route table.

    vtb-bp145q7glnuzdvzu2****
    OwnerId

    integer

    The ID of the Alibaba Cloud account to which the route table belongs.

    253460731706911258
    Description

    string

    The description of the route table.

    This is Route Table.
    RouteTableType

    string

    The type of the route table. Valid values:

    • Custom

    • System

    System
    ResourceGroupId

    string

    The ID of the resource group to which the route table belongs.

    rg-acfmxazb4ph****
    RouterType

    string

    The type of vRouter to which the route table belongs. Valid values:

    • VRouter: a vRouter.

    • VBR: a VBR.

    VRouter
    RouteTableName

    string

    The name of the route table.

    doctest
    Tags

    object

    Tag

    array<object>

    The tags.

    object

    The tags.

    Key

    string

    The tag key.

    type
    Value

    string

    The tag value.

    ingress
    VSwitchIds

    object

    VSwitchId

    array

    The vSwitch IDs.

    string

    The vSwitch IDs.

    vsw-bp12mw1f8k3jgygk9****
    GatewayIds

    object

    GatewayIds

    array

    The detailed information about the IPv4 gateway.

    string

    The detailed information about the IPv4 gateway.

    ipv4gw-5tsnc6s4ogsedtp3k****
    RoutePropagationEnable

    boolean

    Whether propagated routes are received. Valid values:

    • true: received.

    • false: not received.

    true

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidTagKey The tag keys are not valid. The tag index is invalid.
    400 InvalidTagValue The tag values are not valid. The tag value is invalid.
    400 IellgalParameter.OwnerAccount The specified parameter OwnerAccount is not valid. The specified parameter OwnerAccount is illegal.
    403 Forbbiden User not authorized to operate on the specified resource. User not authorized to operate on the specified resource.
    403 Abs.InvalidPayType Specified pay type is not valid.
    403 Abs.InstanceNotExist Specified instance not exist.
    403 Abs.Forbidden Specified instance cannot change pay type.
    403 Abs.InvalidPayPeriod Specified pay period not valid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.