Cisco Cisco Identity Services Engine 1.3 전단

思科身份服务引擎 API 参考指南，版本 1.4

第 5 章      ERS API 简介

  使用外部 RESTful 服务 API 进行版本控制

使用外部 RESTful 服务 API 进行版本控制

外部 RESTful 服务 API 提供与早期 Cisco ISE 版本的向后兼容。外部 RESTful 服务 API 具有用于 
API 版本管理的版本控制机制。所有非访客资源为版本 1.0，无需向后兼容。

每个 RESTful 资源都具有一个模型版本 (major.minor)。版本必须包含在请求标头内，并采用如下
语法：

application/vnd.com.cisco.ise.<resource-namespace>.<resource-type>.<major version>.<minor 

version>+xml

例如，要获取内部用户资源版本 1.0，需要通过以下请求：

DELETE https://<ISE-ADMIN-NODE>:9060/ers/config/internaluser/333

Authorization: Basic xxxxxxxxxxxxxxxxxxx

Accept: application/vnd.com.cisco.ise.identity.internaluser.1.0+xml

对请求进行身份验证和授权后，系统将执行版本匹配检查，并显示下表中提到的匹配结果：

注意

每种资源都具有检索服务器支持的版本列表的 API。

搜索和过滤

所有过滤和搜索操作都通过使用过滤完成。

您可通过向资源 URI 发送 GET 请求搜索资源。默认情况下，结果为第一页（页面索引 = 0），默认
大小为 20。通过向 URI 添加以下部分介绍的过滤器、排序和分页参数，客户端可以控制此搜索。
从分页、过滤器或排序请求生成的资源绑定在 

<resources>

 集合中，此集合包含每个资源的名

称、ID、说明及其完整表示的链接。这使客户端能够轻松地向下展开到资源。

外部 RESTful 服务 API 的过滤参数

您可以通过过滤器查询字符串参数执行简单的过滤操作。您可以发送多个过滤器。默认情况下，
所有过滤器条件通用的逻辑运算符是 AND。您可以通过使用“filtertype=or”查询字符串参数更
改此默认运算符。

每个资源数据模型说明应指定属性是否为已过滤字段。

例如，要获取名字开头为“a”且属于身份组“Finance”的内部用户，应通过以下请求：

GET 

/ers/config/internaluser/?page=0&size=20&sortacs=name&filter=name.STARTSW.a&filter=identit

yGroup.EQ.Finance

版本匹配

结果

未发送版本

服务器返回状态 415“Unsupported Media Type”。

客户端版本等于服务器版本

服务器继续处理请求。

客户端次要版本不等于服务器次要版本

服务器添加描述版本差异的响应警告消息，并继
续处理请求。

客户端和服务器主要版本不匹配 

服务器返回状态 415 以及相应的错误消息。