Cisco Cisco Identity Services Engine 1.3 Fascicule
6-8
思科身份服务引擎 API 参考指南,版本 1.4
OL-26134-01
第 6 章 访客 REST API
搜索和过滤
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:ersResponse
xmlns:ns2="ers.ise.cisco.com" operation="GET-getAll-guestuser">
<link type="application/xml"
href="https://<ISE-Admin-Node>:9060/ers/config/guestuser/" rel="related"/>
<messages>
<ns2:message type="ERROR" code="Resource media type exception">
<title>Wrong media type, check Accept request header.</title>
</ns2:message>
</messages>
</ns2:ersResponse>
版本
Cisco ISE 版本 1.4 的访客 REST API 是 2.0 版本。它可与未来版本兼容。
此 REST API 与早期 alpha 版本和 beta 版本的访客 REST API 不兼容。
每个 RESTful 资源都具有一个模型版本 (major.minor)。版本必须包含在请求标头内,并采用如下
语法:
语法:
application/vnd.com.cisco.ise.<resource-namespace>.<resource-type>.<major version>.<minor
version>+xml
例如,要获取访客用户资源版本 2.0,需要通过以下请求:
GET https://<ISE-ADMIN-NODE>:9060/ers/config/guestuser/333
Authorization: Basic xxxxxxxxxxxxxxxxxxx
Accept: application/vnd.com.cisco.ise.identity.guestuser.2.0+xml
对请求进行身份验证和授权后,系统将执行版本匹配检查,并具有下列匹配结果之一:
搜索和过滤
所有过滤和搜索操作都通过使用过滤完成。
您可通过向资源 URI 发送 GET 请求搜索资源。默认情况下,结果为第一页(页面索引 = 0),默认
大小为 20。通过向 URI 添加以下部分介绍的过滤器、排序和分页参数,客户端可以控制此搜索。
从分页、过滤器或排序请求生成的资源绑定在
大小为 20。通过向 URI 添加以下部分介绍的过滤器、排序和分页参数,客户端可以控制此搜索。
从分页、过滤器或排序请求生成的资源绑定在
<resources>
集合中,此集合包含每个资源的名
称、ID、说明及其完整表示的链接。这使客户端能够轻松地向下展开到资源。
表
6-6
版本匹配结果
版本匹配
结果
未发送版本
服务器返回状态
415 “Unsupported Media Type”
客户端版本等于服务器版本
服务器继续处理请求。
客户端次要版本不等于服务器次要版本
服务器添加描述版本差异的响应警告消息,并
继续处理请求。
继续处理请求。
客户端和服务器主要版本不匹配
服务器返回状态
415
以及相应的错误消息。