跳到主要内容

查询路由器信息

查询路由器信息。

请求参数

参数名参数类型是否必填参数说明
ActionString操作方法:DescribeRouters
RegionString机房标识,取值参见地域列表
OffsetString记录偏移量,不指定取 0
CountString记录数量,不指定为全部
Id.NString路由器 ID,支持多个查询,如Id.0=aa&Id.1=bb
Name.NString路由器名称,支持多个查询,如Name.0=aa&Name.1=bb
EipString路由器外部 IP 地址
StartTimeString到期开始时间 格式yyyy-MM-dd HH:mm:ss
EndTimeString到期结束时间 格式yyyy-MM-dd HH:mm:ss
ProductStatusString产品状态:
  • NORMAL:正常
  • OVERTIMER:过期
  • ARREARAGE:欠费
  • PayTypeString付费类型,取值范围:
  • PREPAID:包年包月
  • PROBATION:试用
  • 返回参数

    名称类型说明
    ActionString执行的操作
    TaskIdString请求标识
    TotalCountInteger过滤条件下总共记录数
    RouterSetRouterItemType由RouterItemType组成的数组格式,返回实例信息

    RouterItemType

    名称类型说明
    IdString路由器 ID
    NameString名称
    DescriptionString描述
    FirewallString防火墙
    FirewallNameString防火墙名称
    StatusString状态
    EipString绑定在路由器上的外部 IP 地址
    CreateTimeDateTime创建时间
    DueTimeDateTime到期时间
    CloseTimeDateTime关闭时间
    PayTypeString支付类型 ONDEMAND:按量付费;PREPAID:包年包月;PROBATION 试用。
    ProductStatusString产品状态,正常:NORMAL 过期:OVERTIMER 欠费:ARREARAGE
    InterfaceSetInterfaceItemType由InterfaceItemType组成的数组格式,返回网卡信息
    EipAssociationSetEipItemType外部 IP 关联列表,描述外部 IP 地址和私有网络 IP 地址的关联信息。
    UserIdString所属用户ID
    LockedBoolean是否锁定

    InterfaceItemType

    名称类型说明
    IdString路由器 ID
    NameString名称
    DescriptionString描述
    FirewallString防火墙
    FirewallNameString防火墙名称
    StatusString状态
    EipString绑定在路由器上的外部 IP 地址
    CreateTimeDateTime创建时间
    DueTimeDateTime到期时间
    CloseTimeDateTime关闭时间
    PayTypeString支付类型 ONDEMAND:按量付费;PREPAID:包年包月;PROBATION 试用。
    ProductStatusString产品状态,正常:NORMAL 过期:OVERTIMER 欠费:ARREARAGE
    InterfaceSetRouterInterfaceItemType私有网络网卡信息列表
    EipAssociationSetEipItemType外部 IP 关联列表,描述外部 IP 地址和私有网络 IP 地址的关联信息。
    UserIdString所属用户ID
    LockedBoolean是否锁定

    RouterInterfaceItemType

    名称类型说明
    IdString网卡标识
    RouterIdString路由器 ID
    NetworkIdString私有网络 ID
    SubnetIdString私有网络子网 ID
    CidrString私有网络CIDR +1.1.2
    MacAddressStringMAC 地址
    IpAddressString私有网络 IP 地址
    StatusString状态
    UserIdString所属用户

    EipItemType

    名称类型说明
    IdString关联 ID
    EipString外部 IP 地址
    DeviceIdString设备ID
    RouterIdString路由器 ID
    LocalIpAddressString私有网络 IP 地址
    LocalNetworkIdString私有网络 ID
    UuidStringFloatingIP UUID

    请求示例

    https://api.chinac.com/v2/?Action=DescribeRouters&Region=cn-wuxi1

    返回示例

    {
    "code": 10000,
    "message": "",
    "data": {
    "TaskId": "98k11520170510153918782",
    "Action": "DescribeRouters",
    "TotalCount": 2,
    "RouterSet": [{
    "Id": "r-2n9ih46fys84f",
    "Uuid": "a231050e-b184-4eb6-810c-4d061e71ad4b",
    "Name": "tet33",
    "Description": null,
    "Firewall": "f-1r9ih3ke3g112",
    "Status": "ENABLED",
    "Eip": null,
    "CreateTime": "2017-05-06T15:34:28 +0800",
    "UseType": "CUSTOMER",
    "DueTime": "2017-05-09T15:34:28 +0800",
    "CloseTime": "2017-05-09T16:34:28 +0800",
    "ProductStatus": "OVERTIMER",
    "PayType": "PROBATION",
    "UserId": "18359229",
    "InterfaceSet": [],
    "IdLong": "r-2n9ih46fys84f-a231050e-b184-4eb6-810c-4d061e71ad4b"
    },
    {
    "Id": "r-vd9ih46dmt2p",
    "Uuid": "bf53cf6e-50e3-4b8c-a3e9-b87b4aa09e71",
    "Name": "test",
    "Description": null,
    "Firewall": "f-1r9ih3ke3g112",
    "Status": "ENABLED",
    "Eip": null,
    "CreateTime": "2017-05-06T13:58:29 +0800",
    "UseType": "CUSTOMER",
    "DueTime": "2017-05-09T13:58:29 +0800",
    "CloseTime": "2017-05-09T14:58:29 +0800",
    "ProductStatus": "OVERTIMER",
    "PayType": "PROBATION",
    "UserId": "18359229",
    "InterfaceSet": [],
    "IdLong": "r-vd9ih46dmt2p-bf53cf6e-50e3-4b8c-a3e9-b87b4aa09e71"
    }]
    }
    }