Skip to content

Latest commit

 

History

History
391 lines (252 loc) · 11.7 KB

ne40ex3.md

File metadata and controls

391 lines (252 loc) · 11.7 KB
Raw

基本介绍

  • 支持华为的NE40EX3型设备的操作。

接口列表

接口名 描述
init 实例初始化
login 登录目标设备
logout 登出目标设备
execute 执行查询命令(普通)
command 执行所有命令(高级)
getPrompt 获取主机提示符，并识别登录设备后所处模式
getMore 自动获取分页消息
cleanBuffer 清除通道内残留信息
privilegeMode 切换至特权模式
generalMode 切换至普通模式
commit 保存配置
showVersion 查看设备版本信息
showRoute 查看路由表信息
showVlan 查看Vlan表信息
showNtp 查看NTP服务器地址信息
showLog 查看SYSLOG服务器地址信息
showSnmp 查看SNMP服务端地址信息
showInterface 查看Interface列表信息

接口详情

  • login

    调用此接口进行登录(参数来自init)，成功后取得shell环境、清除登陆后设备发送的欢迎信息、设置超时时间(timeout)，判断登录设备是否遇到密码过期提醒需要修改、以及取得主机提示符，比如 [root@localhost ] # 。

    功能特性继承自baseHuawei

  • execute

    在目标设备上执行一个查询命令，比如show、display，然后取得该命令的执行结果，最后返回一个字典（dict）格式的数据。

    注意： 不要使用该接口执行切换模式的命令，比如enable、sys、config、interface，也不要在切换模式后使用该接口,如果真的有需要，请使用command高级开发接口。

    功能特性继承自baseHuawei

  • command

    在目标设备上执行任何命令，然后一直等待收取该命令的执行结果，直到预期的消息出现或等待超时为止，最后返回一个字典（dict）格式的数据。

    功能特性继承自baseHuawei

  • getPrompt

    取得目标设备上的主机提示符，比如：TEST-N7710-1# 、TEST-N7710-1> 等。

    注意：该接口一般仅用于Forward内部使用。

    功能特性继承自baseHuawei

  • getMore

    自动获取因一个命令结果较长而导致的分页内容。

    注意：该接口仅用于Forward内部使用。

    功能特性继承自baseHuawei

  • cleanBuffer

    清除在socket内，因接受消息不彻底而遗留的字符数据。

    注意：execute、command在每次执行命令之前会自动调用该接口进行清除，该接口一般只用于Forward内部使用。

    功能特性继承自baseHuawei

  • privilegeMode

    在设备上，切换至特权(sys)模式。

    注意：账户需要具备权限才能切换，否则不能切换。

    功能特性继承自baseHuawei

  • generalMode

    在设备上，切换至至普通模式。而在调用之前，无需关心设备处于哪一级模式下。

    注意：保存配置需要降低至该模式下。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content str 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 切换失败

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.generalModeMode()
 >>> {"status":True,"content":"","errLog":""}

  • commit

    在设备上，当配置好一些参数后，可以调用该接口进行保存配置。而在调用之前，无需关心设备处于哪一级模式下。

    注意：调用该接口需要shell处于特权模式下（华为设备除外），在这个过程中可能会需要特权模式密码。所以在Forward登录之初，就应该传递特权模式密码以备用，如果设备不需要特权模式密码，则可以不用传递。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content str 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 保存失败

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.commit()
 >>> {"status":True,"content":"保存成功","errLog":""}

  • showVersion

    查看设备的软件版本信息。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content str 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 命令执行失败

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.showVersion()
 >>> {"status":True,"content":"V7.1.2.3","errLog":""}

  • showRoute

    查看设备的路由表信息。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content list 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果 路由列表的详细字段
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 命令执行失败
      字段 类型 描述 样例
      net str 网段 192.168.1.0
      mask str 掩码 24
      metric str metric值 1
      type str 路由类型 ospf
      description str 描述 无
      interface str 网卡口 g1
      via str 下一跳网关地址 10.0.0.1

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.showRoute()
 >>> {"status":True,"content":[{...},{...}],"errLog":""}

  • showVlan

    查看设备的Vlan列表信息。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content list 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果 Vlan列表的详细字段
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 命令执行失败
      字段 类型 描述 样例
      id str ID 20
      description str 描述 无
      status str 状态 无
      type str Vlan类型 无

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.showVlan()
 >>> {"status":True,"content":[{...},{...}],"errLog":""}

  • showNtp

    查看设备的NTP服务器地址列表信息。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content list 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果 ["192.168.1.1","192.168.1.2"]
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 命令执行失败

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.showNtp()
 >>> {"status":True,"content":["192.168.1.1","192.168.1.2"],"errLog":""}

  • showLog

    查看设备的SYSLOG服务器地址列表信息。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content list 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果 ["192.168.2.1","192.168.2.2"]
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 命令执行失败

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.showLog()
 >>> {"status":True,"content":["192.168.2.1","192.168.2.2"],"errLog":""}

  • showSnmp

    查看设备的SYSLOG服务器地址列表信息。

    注意：该接口只获取trap模式的SNMP服务器地址列表。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content list 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果 ["192.168.3.1","192.168.3.2"]
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 命令执行失败

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.showSnmp()
 >>> {"status":True,"content":["192.168.3.1","192.168.3.2"],"errLog":""}

  • showInterface

    查看设备的Interface列表信息。

    • 调用参数

      无。

    • 返回参数

      字段 类型 描述 样例
      status bool 调用该接口是否成功 False
      content list 调用该接口所产生的正确内容输出,但可能为空，这取决于所执行命令的结果 Interface数据格式字段
      errLog str 调用该接口所产生的错误内容或Forward的错误提示信息 命令执行失败
      字段 类型 描述 样例
      interfaceName str 名称 ge/0/1/1
      members list 接口绑定的网卡 [....]
      lineState str 接口状态 enable或其他叫法
      adminSteate str 管理状态 admin down等等
      description str 描述 无
      speed str 接口速率 100M/bps
      type str 接口类型 各个设备型号叫法不一
      duplex str 工作模式 双工/半双工/自动
      inputRate str 接口吞数据量速率 无
      outputRate str 接口吐数据量速率 无
      crc str CRC值 无
      mtu str MTU值 1500
      ip str 接口配置的IP地址 192.168.1.1

    • 案例

     >>> instance=......
 >>> instance.login()
 >>> instance.showInterface()
 >>> {"status":True,"content":[{...},{...}],"errLog":""}