AOS-CX 10.07 REST V1 API指南帮助中心
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://
在将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/primary_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/primary_auth_cookie \“ https://192.0.2.5/vsx-peer/rest/v1/system/界面?depth = 1&属性=名称,ipv4_address”
有关VSX的更多信息,请参阅虚拟开关扩展(VSX)指南。