调用ListTransitRouterRouteEntries接口查询企业版转发路由器路由表中的路由条目信息。

调试

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

请求参数

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

要执行的操作。取值:ListTransitRouterRouteEntries

TransitRouterRouteTableId String vtb-bp1dudbh2d5na6b50****

企业版转发路由器路由表ID。

MaxResults Integer 4

分批次查询时,每次显示的条目数。取值范围:1~100。默认值为20

TransitRouterRouteEntryDestinationCidrBlock String 192.168.0.0/24

路由条目的目标网段。

TransitRouterRouteEntryStatus String Active

路由条目的状态。取值:

  • Creating:添加中。
  • Active:可用。
  • Deleting:删除中。
TransitRouterRouteEntryNames.N RepeatList testname

路由条目的名称。

名称长度为0~128个字符,可包含英文字母、数字、中文、半角逗号(,)、半角句号(.)、半角分号(;)、正斜线(/)、at(@)、下划线(_)和短划线(-)。

您可以一次查询多个路由条目的信息。N的最大值为20

说明 系统仅支持通过本参数查询静态配置的路由。
TransitRouterRouteEntryIds.N RepeatList rte-oklkgwmj97z6dn****

路由条目ID。

您可以一次查询多个路由条目的信息。N的最大值为20

说明 系统仅支持通过本参数查询静态配置的路由。
NextToken String fce19****

分批次查询时,下一次查询的Token。

返回数据

名称 类型 示例值 描述
MaxResults Integer 4

分批次查询时,每次显示的条目数。

NextToken String fce19****

分批次查询时,下一次查询的Token。

RequestId String C3835E5E-1504-4344-B1BB-98A4110F1079

请求ID。

TotalCount Integer 6

总条目数。

TransitRouterRouteEntries Array of TransitRouterRouteEntry

路由条目信息列表。

CreateTime String 2021-06-15T07:01Z

路由条目的创建时间。

时间按照ISO8601标准表示,并使用UTC时间。格式为:YYYY-MM-DDThh:mmZ。

说明 只有静态配置的路由才会返回该参数值。
TransitRouterRouteEntryDescription String testdesc

路由条目的描述信息。

说明 只有静态配置的路由才会返回该参数值。
TransitRouterRouteEntryDestinationCidrBlock String 172.16.0.0/16

路由条目的目标网段。

TransitRouterRouteEntryId String rte-oklkgwmj97z6dn****

路由条目ID。

说明 只有静态配置的路由才会返回该参数值。
TransitRouterRouteEntryName String test

路由条目的名称。

说明 只有静态配置的路由才会返回该参数值。
TransitRouterRouteEntryNextHopId String tr-attach-vx6iwhjr1x1j78****

路由条目的下一跳ID。

TransitRouterRouteEntryNextHopType String BlackHole

路由条目的下一跳类型。

  • BlackHole:表示该路由条目为黑洞路由,所有去往目标网段的路由均会被丢弃。
  • Attachment:表示该路由条目的下一跳为网络实例连接,所有去往目标网段的路由均会被转发至指定的网络实例连接。
TransitRouterRouteEntryStatus String Active

路由条目的状态。

  • Creating:添加中。
  • Active:可用。
  • Deleting:删除中。
TransitRouterRouteEntryType String Propagated

路由条目的类型。

  • Static:表示该路由条目为静态配置的路由。
  • Propagated:表示该路由条目为自动学习到的路由。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterRouteEntries
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&<公共请求参数>

正常返回示例

XML格式

<ListTransitRouterRouteEntriesResponse> 
  <TotalCount>6</TotalCount>
  <NextToken>fce19****</NextToken>
  <RequestId>C3835E5E-1504-4344-B1BB-98A4110F1079</RequestId>
  <MaxResults>4</MaxResults>
  <TransitRouterRouteEntries>
        <TransitRouterRouteEntryDestinationCidrBlock>10.0.1.0/24</TransitRouterRouteEntryDestinationCidrBlock>
        <TransitRouterRouteEntryNextHopId>tr-attach-vx6iwhjr1x1j78****</TransitRouterRouteEntryNextHopId>
        <TransitRouterRouteEntryType>Propagated</TransitRouterRouteEntryType>
        <TransitRouterRouteEntryNextHopType>Attachment</TransitRouterRouteEntryNextHopType>
        <TransitRouterRouteEntryStatus>Active</TransitRouterRouteEntryStatus>
  </TransitRouterRouteEntries>
  <TransitRouterRouteEntries>
        <TransitRouterRouteEntryDestinationCidrBlock>10.0.137.40/29</TransitRouterRouteEntryDestinationCidrBlock>
        <TransitRouterRouteEntryNextHopId>tr-attach-vx6iwhjr1x1j78****</TransitRouterRouteEntryNextHopId>
        <TransitRouterRouteEntryType>Propagated</TransitRouterRouteEntryType>
        <TransitRouterRouteEntryNextHopType>Attachment</TransitRouterRouteEntryNextHopType>
        <TransitRouterRouteEntryStatus>Active</TransitRouterRouteEntryStatus>
  </TransitRouterRouteEntries>
  <TransitRouterRouteEntries>
        <TransitRouterRouteEntryDestinationCidrBlock>10.0.2.0/24</TransitRouterRouteEntryDestinationCidrBlock>
        <TransitRouterRouteEntryNextHopId>tr-attach-vx6iwhjr1x1j78****</TransitRouterRouteEntryNextHopId>
        <TransitRouterRouteEntryType>Propagated</TransitRouterRouteEntryType>
        <TransitRouterRouteEntryNextHopType>Attachment</TransitRouterRouteEntryNextHopType>
        <TransitRouterRouteEntryStatus>Active</TransitRouterRouteEntryStatus>
  </TransitRouterRouteEntries>
  <TransitRouterRouteEntries>
        <TransitRouterRouteEntryDestinationCidrBlock>172.16.0.0/16</TransitRouterRouteEntryDestinationCidrBlock>
        <TransitRouterRouteEntryNextHopId></TransitRouterRouteEntryNextHopId>
        <TransitRouterRouteEntryType>Static</TransitRouterRouteEntryType>
        <CreateTime>2021-06-15T07:01Z</CreateTime>
        <TransitRouterRouteEntryNextHopType>BlackHole</TransitRouterRouteEntryNextHopType>
        <TransitRouterRouteEntryName>test</TransitRouterRouteEntryName>
        <TransitRouterRouteEntryId>rte-oklkgwmj97z6dn****</TransitRouterRouteEntryId>
        <TransitRouterRouteEntryStatus>Active</TransitRouterRouteEntryStatus>
  </TransitRouterRouteEntries>
</ListTransitRouterRouteEntriesResponse>

JSON格式

{
  "TotalCount": 6,
  "NextToken": "fce19****",
  "RequestId": "C3835E5E-1504-4344-B1BB-98A4110F1079",
  "MaxResults": 4,
  "TransitRouterRouteEntries": [
    {
      "TransitRouterRouteEntryDestinationCidrBlock": "10.0.1.0/24",
      "TransitRouterRouteEntryNextHopId": "tr-attach-vx6iwhjr1x1j78****",
      "TransitRouterRouteEntryType": "Propagated",
      "TransitRouterRouteEntryNextHopType": "Attachment",
      "TransitRouterRouteEntryStatus": "Active"
    },
    {
      "TransitRouterRouteEntryDestinationCidrBlock": "10.0.137.40/29",
      "TransitRouterRouteEntryNextHopId": "tr-attach-vx6iwhjr1x1j78****",
      "TransitRouterRouteEntryType": "Propagated",
      "TransitRouterRouteEntryNextHopType": "Attachment",
      "TransitRouterRouteEntryStatus": "Active"
    },
    {
      "TransitRouterRouteEntryDestinationCidrBlock": "10.0.2.0/24",
      "TransitRouterRouteEntryNextHopId": "tr-attach-vx6iwhjr1x1j78****",
      "TransitRouterRouteEntryType": "Propagated",
      "TransitRouterRouteEntryNextHopType": "Attachment",
      "TransitRouterRouteEntryStatus": "Active"
    },
    {
      "TransitRouterRouteEntryDestinationCidrBlock": "172.16.0.0/16",
      "TransitRouterRouteEntryNextHopId": "",
      "TransitRouterRouteEntryType": "Static",
      "CreateTime": "2021-06-15T07:01Z",
      "TransitRouterRouteEntryNextHopType": "BlackHole",
      "TransitRouterRouteEntryName": "test",
      "TransitRouterRouteEntryId": "rte-oklkgwmj97z6dn****",
      "TransitRouterRouteEntryStatus": "Active"
    }
  ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidTransitRouterRouteTableId.NotFound TransitRouterRouteTableId is not found. 转发路由器路由表实例ID未找到。

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