全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
专有网络 VPC

DescribeRouterInterfaces

更新时间:2018-04-09 22:25:28

描述

查询指定地域内路由器接口的列表。

每个过滤条件(filter key)可以提供多个值,多个值之间是“or”关系,即只要与其中一个值符合则视为符合参数的过滤条件。

各个过滤条件(filter key)之间为“and”逻辑关系,即符合所有参数的过滤条件,才会被查询出来。

请求参数

名称 类型 是否必须 描述
Action string 接口名,系统规定参数。

取值:DescribeRouterInterfaces

RegionId string 路由器接口所在的地域。

您可以从地域和可用区列表或通过调用DescribeRegions接口查询地域ID。

Filter.n.Key string

过滤条件,最多可提供5个过滤条件。n的取值范围为[1,5]。可用的过滤条件如下:

  • RouterInterfaceId:路由器接口ID。

  • RouterId:路由器(VRouter或者VBR)的ID。

  • RouterType:路由器接口关联的路由器类型,VRouter或VBR。

  • RouterInterfaceOwnerId:路由器接口的账号ID。

  • OppositeInterfaceId:对端路由器接口ID。

  • OppositeRouterType:对端路由器接口关联的路由器类型,VRouter或VBR。

  • OppositeRouterId:对端路由器(VRouter或者VBR)的ID。

  • OppositeInterfaceOwnerId:对端路由器接口的账号ID。

  • Status:路由器接口的状态。

  • Name:路由器接口的名称。

Filter.n.Value.m String No 对应过滤条件的值。m的取值范围为[1, 5]。
PageNumber int 实例状态列表的页码,默认值为1。
PageSize int 指定分页查询时每页的行数,最大值为50,默认值为10。

返回参数

名称 类型 描述
RequestId String 请求ID。
TotalCount Integer 列表的条目数。
PageNumber Integer 当前分页的页码。
PageSize Integer 当前分页包含的条目数。
RouterInterfaceSet RouterInterfaceSetType 路由器接口的详细信息,详情参见RouterInterfaceSetType

错误码

关于本接口的错误码的详细解释,请参见VPC API错误中心

示例

请求示例

  1. http://vpc.aliyuncs.com/?Action=DescribeRouterInterfaces
  2. &RegionId=cn-beijing
  3. &<公共请求参数>

返回示例

  1. {
  2. "PageNumber": 1,
  3. "TotalCount": 1,
  4. "PageSize": 10,
  5. "RequestId": "3F12D2E8-0B95-46F3-BE89-C2D69BF134D0",
  6. "RouterInterfaceSet": {
  7. "RouterInterfaceType": [
  8. {
  9. "ChargeType": "AfterPay",
  10. "OppositeInterfaceBusinessStatus": "Normal",
  11. "RouterInterfaceId": "ri-2ze7fbuohm7pcxxxxx",
  12. "OppositeInterfaceStatus": "Active",
  13. "Spec": "Negative",
  14. "OppositeAccessPointId": "ap-cn-beijing-dx-A",
  15. "OppositeInterfaceOwnerId": "12315790855xxxxx",
  16. "OppositeInterfaceSpec": "Large.1",
  17. "CreationTime": "2018-03-01T07:19:31Z",
  18. "RouterType": "VRouter",
  19. "Status": "Active",
  20. "OppositeRouterType": "VBR",
  21. "OppositeRouterId": "vbr-2zee2e2cwetx4xxxxxx",
  22. "OppositeInterfaceId": "ri-2ze07ad6sgzixxxxx",
  23. "VpcInstanceId": "vpc-2zefsil0x93dguxxxxx",
  24. "RouterId": "vrt-2zepuy8qbrq6xxxxx",
  25. "ConnectedTime": "2018-03-01T07:19:32Z",
  26. "OppositeRegionId": "cn-beijing",
  27. "BusinessStatus": "Normal",
  28. "Role": "AcceptingSide",
  29. "EndTime": "2999-09-08T16:00:00Z"
  30. }
  31. ]
  32. }
  33. }
本文导读目录