Cisco Cisco Identity Services Engine 1.2 产品宣传页

7-14

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

OL-26134-01

第 7 章外部 RESTful 服务 API 操作

适用于终端的外部 RESTful 服务 API

撤销注册终端 API 调用的请求示例

PUT https://<ISE-ADMIN-NODE>:9060/ers/config/endpoint/123/deregister

Authorization: Basic xxxxxxxxxxxxxxxxxxx

Content-Type: application/vnd.com.cisco.ise.identity.endpoint.1.0+xml

撤销注册终端 API 调用的响应示例

HTTP/1.1 204 No Content

Date: Thu, 12 Jul 2012 23:59:59 GMT

启动终端批量执行

通过批量执行，您可以在单个请求中发送最多 500 项类型相同的 CRUD 操作。
如果请求有效，服务器将返回状态代码

202 (ACCEPTED)

，并在 LOCATION 响应头中包含唯一的批

量标识符，您可以使用此标识符通过获取批量状态操作跟踪批量状态。

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

503 (Service Unavailable)

，并包含相应的要求客户端稍后重试的描述性消息。

启动终端批量执行 API 调用的请求示例

PUT https://<ISE-ADMIN-NODE>:9060/ers/config/endpoint/bulk HTTP/1.1

Host: {some-ise-node-ip}

Authorization: Basic xxxxxxxxxxxxxxxxxxx Content-Type:

application/vnd.com.cisco.ise.ers.endpointbulkrequest.1.0+xml

{

<ns3:endpointBulkRequest

resourceMediaType = "vnd.com.cisco.ise.ers.identity.endpoint.1.0+xml" operationType =

"create"

xmlns:ns2 = "ers.ise.cisco.com"

xmlns:ns3 = "identity.ers.ise.cisco.com">

<resourcesList> <resource

xsi:type = "ns3:ersEndPoint"

description = "created by bulk request"

xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"> <mac>11:22:33:44:55:66</mac>

<staticGroupAssignment>false</staticGroupAssignment>

<staticProfileAssignment>false</staticProfileAssignment>

</resource>

表

7-16

启动终端批量执行的主要特征

说明

启动执行

摘要

PUT /ers/config/endpoint/bulk

请求头

Accept、Authorization、Host

查询字符串

不适用

请求消息正文

批量请求

响应头

Content-Length、Content-Type

响应消息正文

不适用

响应状态

202、400、401、403、404、415、500