Cisco Cisco Identity Services Engine 1.3 전단

다운로드
페이지 164
 
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 小时的状态报告。
如果对资源执行操作时出现故障,故障将记录在状态报告中,系统会继续执行到下一个资源。
一次只允许执行一个批量操作。如果在另一个批量操作仍在执行时发布批量操作请求,服务器将
返回响应状态 
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 - 服务器错误
下表提供有关状态代码的更多信息。