Cisco Cisco Identity Services Engine 1.3 전단

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

第 5 章      ERS API 简介

  批量操作

下表显示外部 RESTful 服务的强制链接属性：

搜索结果中的链接示例 

以下示例显示搜索结果中的链接：

<ns2:searchResult xmlns:ns2="ers.ise.cisco.com"   total="1163">

<link rel="self" 

href="http://cisco.com/ers/config/internaluser?page=0&size=20"             

type="application/xml"/>

<link rel="next" href="http://cisco.com/ers/config/internaluser?page=20&size=20"       

type="application/xml"/>

<resources>

<link rel="john doe" href="http://cisco.com/ers/config/internaluser/333"       

type="application/xml"/>

<link rel="jeff smit" href="http://cisco.com/ers/config/internaluser/444"       

type="application/xml"/>

.

.

.

</resources>

</ns2:searchResult>

批量操作

通过批量操作请求，您可以在单个请求中发送最多 500 项操作（或每个 ID 5000 项操作）。您可
以对所有资源运行创建、更新和删除操作，也可以运行某些特定于资源的操作，如注册终端。

请求中的所有操作必须具有相同类型，也就是说您不能发送混合资源请求。

每种资源都有自己的事务，并且由于是多线程执行，因此不保证事务的顺序。

Cisco ISE 服务器解析请求并验证其结构。如果请求有效且未进行其他批量操作，系统将开始执
行，且服务器将返回状态代码 

202 (ACCEPTED)

 并在 LOCATION 响应头中显示唯一的批量标识

符。通过此 ID，您稍后可以使用获取批量状态操作跟踪批量状态。您可以获取操作开始之后至少 
2 小时的状态报告。

如果对资源执行操作时出现故障，故障将记录在状态报告中，系统会继续执行到下一个资源。

一次只允许执行一个批量操作。如果在另一个批量操作仍在执行时发布批量操作请求，服务器将
返回响应状态 

503 (Service Unavailable)

，并包含要求客户端稍后重试的消息。

属性

说明

Href

此属性包含链接的 URI。

Rel

此属性的最初含义为“关系”，表示以下链接
类型：

“self”- 刷新当前表示的链接

“next”- 在获取下一个页面的集合中

“info”- 获取资源的更多信息

类型

提示服务器可能为链接的 URI 返回的表示的介
质类型，通常为“application/xml”。