主题规则uris

主题是开关资源的URI:

  • 并非所有的开关资源uris都被支持为通知主题。

    实施注释资源的获取方法部分AOS-CXREST API参考指示是否不受通知子系统的支持。

  • 通配符角色(*)不支持。

  • 通过包括/vsx-peer在URI中,主题订阅消息不支持。要指定同行开关,包括/vsx-peer在WSS连接的URL中。例如,要获取有关对等方面VLAN的通知,请首先打开连接wss://192.0.2.5/vsx-peer/rest/V10.04/通知然后订阅/休息/V10.04/系统/VLAN作为主题名称。

  • 您可以指定特定的资源实例或资源集合。

    特定资源实例的示例:

    • /休息/V10.04/system/vrfs/默认

    • /休息/V10.04/system/vlans/1

    资源收集示例:

    • /休息/V10.04/system/vrfs/default/bgp_routers

    • /休息/V10.04/系统/VLAN

  • 深度支持查询参数,最大值2,只有资源收集。例如:

    • 正确的:/休息/V10.04/system/vlans?depth = 1

    • 不正确:/休息/V10.04/system/vlans?depth = 3。

  • 属性支持查询参数。您可以在查询字符串中为资源集或资源实例指定逗号分隔的属性名称列表。如果指定属性,则仅在指定属性之一更改时,订户仅在一个指定属性的值时收到通知消息。

    例如:

    • 以下URI指定了交换机上所有接口的管理状态和链接状态:

      /休息/V10.04/system/Interfaces?attributes = admin_state,link_state

    • 以下URI指定了VLAN的名称:

      /休息/V10.04/system/vlans?depth = 2&属性=名称

    笔记:

    AOS-CX 10.06版本中不支持对按需属性的订阅。

    例如,对于以下订阅消息:

    {“ type”:“订阅”,“主题”:[{“ name”:“/rest/v10.04/system/interfaces?attributes = statistics'}]}}

    发送相应的错误消息:

    {“ type”:“ error”,“ message”:“统计信息是资源接口的按需属性”,“ data”:null}

    属性的名称必须匹配所记录的名称AOS-CXREST API参考对于资源的GET方法。