VSX对等开关和REST API访问

如果启用了虚拟开关扩展名(VSX),则可以访问对等方开关的REST API,而无需单独登录或管理该对等方开关的会话cookie。

要从您的连接开关访问同行REST API,请插入/vsx-peer在服务器URL之后和REST API和版本标识符之前的URI路径中。

例如:

https://192.0.2.5/vsx-peer/休息/v1/...
笔记:

以下用途/vsx-peer在URI路径中不支持:

  • 您不能指定登录资源。请求/vsx-peer/rest/v1/登录不需要,因为登录到一个设备会自动使您访问对等设备。

  • 您无法访问VSX对等开关的Web UI。将浏览器地址设置为https:///vsx-peer不支持。

  • 您无法在实时通知框架中的主题订阅消息中的URI中指定vsx对等开关。但是,您可以通过将连接地址设置为以下内容来访问VSX对等开关上的实时通知框架:

    wss:///vsx-peer/rest/v1/通知

在将REST API与VSX一起使用时,请注意以下几点。

  • 必须在两个交换机上启用VSX,并且必须向上启用InterWitch链接(ISL)。

  • 必须在连接到的开关上启用REST API访问。

  • 对于写入访问,必须将REST API访问模式设置为在您所连接的开关上读取写入。

  • 您必须登录到您所连接的开关。例如,如果您连接到主VSX开关,则必须登录到主开关。

  • 当启用配置同步时,主VSX开关上支持的配置更改将在辅助VSX开关上复制。更改次级VSX开关的配置可能会导致配置不同步。

  • 审核消息在对等开关上记录,并附有从用户连接的开关的用户信息。

卷曲命令的示例

  • 在IP地址连接到主VSX开关时,获取次级VSX开关的VSX状态192.0.2.5:

    $curl -noproxy“ 192.0.2.5” -K get \ -b/tmp/priendar_auth_cookie \“ https://192.0.2.5/vsx-peer/rest/v1/system/vsx?attibutes = oper_status“
  • 在IP地址192.0.2.6上连接到辅助VSX开关时,获取主VSX开关的VSX状态:

    $curl -noproxy“ 192.0.2.6” -K get \ -b/tmp/tmp/sectary_auth_cookie \“ https://192.0.2.6/vsx-peer/rest/v1/system/vsx?attibutes = oper_status“
  • 在IP地址192.0.2.5上连接到主VSX开关时,在辅助VSX开关上获取接口的名称和IP地址:

    $curl -noproxy“ 192.0.2.5” -K get \ -b/tmp/priendar_auth_cookie \“ https://192.0.2.5/vsx-peer/rest/v1/system/界面?depth = 1&属性=名称,ipv4_address”

有关VSX的更多信息,请参阅虚拟开关扩展(VSX)指南