Rules for topic URIs

A topic is the URI of a switch resource:

  • Not all switch resource URIs are supported as notification topics.

    The Implementation Notes section of the GET method of the resource in the ArubaOS-CX REST API Reference indicates if the resource is not supported by the notifications subsystem.

  • Wildcard characters (*) are not supported.

  • Specifying a resource on a peer VSX switch by including /vsx-peer is not supported. To specify a peer switch, include /vsx-peer in the URL of the WSS connection.

  • You can specify a specific resource instance or a collection of resources.

    Examples of specific resource instances:

    • /rest/v1/system/vrfs/default

    • /rest/v1/system/vlans/DEFAULT_VLAN_1

    • /vsx-peer/rest/v1/system/vlans/DEFAULT_VLAN_1

    Examples of resource collections:

    • /rest/v1/system/vrfs/default/bgp_routers

    • /rest/v1/system/vlans

  • The depth query parameter is supported with a maximum value of 1 with resource collections only. For example:

    • Correct: /rest/v1/system/vlans?depth=1

    • Incorrect: /rest/v1/system/vlans/2?depth=1

  • The attributes query parameter is supported. You can specify a comma-separated list of attribute names in the query string for either resource collections or resource instances. If attributes are specified, then the subscriber receives notification messages only when the value of one of the specified attributes changes.

    For example:

    • The following URI specifies the administrative state and link state of all interfaces on the switch:

      /rest/v1/system/interfaces?attributes=admin_state,link_state

    • The following URI specifies the names of the VLANs:

      /rest/v1/system/bridge/vlans?depth=1&attributes=name

    The names of the attributes must match the names as documented in the ArubaOS-CX REST API Reference for the GET method of the resource.