一般故障排除提示

连接性

连接通常是您遇到的第一个问题。确保您在要使用的VRF上启用了HTTPS服务器。

  • 要通过管理(OOBM)端口连接到REST API,必须在管理VRF上启用REST API访问。
  • 要通过数据端口连接到REST API,必须在默认VRF或包含该数据端口的用户创建的VRF上启用REST API访问。

资源,属性和行为

  • 交换软件的不同版本之间的资源,属性和行为可能会有所不同。例如:

    从静止V1 URI的URI路径中消除了资源AOS-CX版本10.03:

    • 获取运行开关的VLAN列表的示例AOS-CX版本10.02:
    • 获取“ https://192.0.2.5/rest/v1/system/bridge/vlans”

    • 获取运行开关的VLAN列表的示例AOS-CX版本10.03:
    • 获取“ https://192.0.2.5/rest/v1/system/vlans”

    如果您在使用不同软件版本的转换请求时遇到错误,请使用AOS-CX每个开关上的REST API引用以比较资源的URI路径和属性。您可能需要更改代码以处理不同的软件版本。

  • REST API的不同版本之间的资源,属性和行为可能会有所不同,并且A交换机支持通过REST API的多个版本的访问。

获取,放置,发布和删除方法

  • 大多数资源不允许发布,放置或删除方法,也不允许在AOS-CXREST API参考,除非将REST访问模式设置为读写
  • 资源的JSON模型可以因使用的方法而异。您从GET方法中收到的JSON数据与您可以或必须使用帖子或PUT方法提供的JSON数据不同:
    • GET方法模型包含所有属性。
    • POST方法模型仅包含配置属性。
    • PUT方法模型仅包含可变(可变的)配置属性。如果您不提供PUT请求的请求正文中的所有可变属性,则您未提供的那些属性将设置为它们的默认值,这些属性可能是空的。如果您尝试在PUT请求中提供不变的属性,则会返回错误。
  • 使用GET方法与选择器=配置参数仅获取资源的配置属性。您可以使用AOS-CXREST API引用查看有关受支持的方法和资源模型的信息。
  • 您可以通过获取产品信息属性或子系统集合的请求获取其他平台特定信息。Aruba 8400开关示例:
    • 示例请求:
    • 获取“ https://192.0.2.5/rest/v1/system/subsystems”

      示例响应主体:

      [ “/休息/v1/System/Subsystems/底盘,基础“,”/REST/v1/system/subsystems/line_card,1%2f3“,”/rets/v1/System/Subsystems/Management_Module,1%2F5“]
    • 示例请求:

      获取“ https://192.0.2.5/rest/v1/system/subsystems/底盘,基础?属性= product_info”

      示例响应主体:

      {“ product_info”:{“ base_mac_address”:“ 00:00:5E:00:00:53:00”,“ device_version”:“”,“实例”,“ 1”,“ number_of_macs”,“”:"JL375A", "product_description": "8400 8-slot Chassis/3xFan Trays/18xFans/Cable Manager/X462 Bundle", "product_name": "8400 Base Chassis/3xFT/18xFans/Cbl Mgr/X462 Bundle", "serial_number": "SG00A2A00A", "vendor": "Aruba" } }
  • Aruba 8320开关示例:
    示例请求:
  • 获取“ https://192.0.2.5/rest/v1/system/subsystems

    示例响应主体:

    [“/REST/V1/SYSTEM/SUBSYSTEMS/CANSIS/BASE”,“/REST/V1/SYSTEM/SUBSYSTEMS/LINE_CARD,1%2F1”,/REST/REST/V1/SYSTEM/SUBSYSTEMS/MANSECTINS/MANSECTION_MODULE,1%2F1”]

硬件和其他功能

  • 不同的开关具有不同的硬件和功能。例如,某些交换机的管理模块资源ID为1/1,其他开关为1/4或1/5。要获取有关开关模型的信息,请使用URI使用get方法请求。platform_name系统属性。

    例如:

    获取“ https://192.0.2.5/rest/v1/system?属性= platform_name”

    以下是Aruba 8320开关的响应主体的示例:

    {“ platform_name”:“ 8320”}

    以下是Aruba 8400开关的响应主体的示例:

    {“ platform_name”:“ 8400x”}
  • “端口”和“接口”一词的含义与其他网络操作系统不同。在里面AOS-CX操作系统:
    • 端口是端口的逻辑表示。
    • 接口是端口的硬件表示。
  • 您可以使用调试命令。模块名称是休息。您可以指定所有严重性日志级别或最低严重性日志级别。

    指定所有严重性日志级别的示例:

    转变#调试全部休息

    指定最低严重性日志的示例错误

    转变#调试休息所有严重性错误