Cisco Cisco Identity Services Engine Software Prospecto
6-5
思科身份服务引擎 API 参考指南,版本 1.4
OL-26134-01
第 6 章 访客 REST API
访客 REST API 响应
</guestInfo>
<guestType>Daily</guestType>
<personBeingVisited>sponsor</personBeingVisited>
<portalId>portal101</portalId>
<reasonForVisit>interview</reasonForVisit>
</ns2:guestuser>
注意
JSON 不用于访客 REST API。
批量执行
通过批量操作请求,您可以在单个请求中发送最多 500 项操作,或根据 ID 发送最多 5000 项操作。
请求中的所有操作必须具有相同类型,也就是说您不能发送混合资源请求。
每种资源都有自己的事务,并且由于是多线程执行,因此不保证事务的顺序。
Cisco ISE 服务器解析请求并验证其结构。如果请求有效且未进行其他批量操作,系统将开始执
行,且服务器将返回状态代码
行,且服务器将返回状态代码
202 (ACCEPTED)
并在 LOCATION 响应头中显示唯一的批量标识
符。通过此 ID,您稍后可以使用获取批量状态操作跟踪批量状态。您可以获取操作开始之后至少
2 小时的状态报告。
2 小时的状态报告。
如果对资源执行操作时出现故障,故障将记录在状态报告中,系统会继续执行到下一个资源。
一次只允许执行一个批量操作。如果在另一个批量操作仍在执行时发布批量操作请求,服务器将
返回响应状态
返回响应状态
503 (Service Unavailable)
,并包含要求客户端稍后重试的消息。
批量执行(包括获取批量状态)使用不同的标头:
•
Content Type 为:
application/vnd.com.cisco.ise.identity.guestuserbulkrequest.1.0+xml
•
Accept 为:
application/vnd.com.cisco.ise.identity.guestuserbulkrequest.1.0+xml
相关主题
•
访客 REST API 响应
每个请求随后都会收到服务器 HTTPS 响应,此响应包括标准标头和响应内容。
响应状态代码
响应包含一个 HTTP 状态代码。对于访客 REST API,这些代码可以是下列代码之一:
•
20x - 操作成功
•
4xx - 客户端错误
•
5xx - 服务器错误
下表提供有关状态代码的更多信息。