Cisco Cisco Identity Services Engine 1.2 产品宣传页

7-39

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

OL-26134-01

第 7 章外部 RESTful 服务 API 操作

适用于访客用户的外部 RESTful 服务 API

重置访客用户帐户的密码

此操作允许您重置访客用户帐户的密码。此操作需要使用访客帐户 ID。此操作会返回生成的新密
码，您无法使用 REST API 指定自己的密码。

重置访客用户的密码示例

请求

PUT https://<ISE-ADMIN-NODE>:9060/ers/config/guestuser/resetpassword/7777

Authorization: Basic xxxxxxxxxxxxxxxxxxx

Accept: application/vnd.com.cisco.ise.identity.guestuser.2.0+xml

响应

HTTP/1.1 204 OK

Date: Sat, 15 Dec 2014 10:20:48 GMT

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<ns2:operationResult xmlns:ns2="ers.ise.cisco.com">

</attributesList>

</ns2:operationResult>

启动访客用户的批量执行

通过批量操作请求，您可以在单个请求中发送最多 500 项操作，或根据 ID 发送最多 5000 项操作。
如果请求有效，服务器将返回状态代码

202 (ACCEPTED)

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

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

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

503 (Service Unavailable)

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

表

7-41

获取

API

版本的主要特征

说明

重置指定访客用户的密码

摘要

PUT /ers/config/guestuser/resetpassword/{id}

请求头

Accept、Authorization、Host

查询字符串

不适用

请求消息正文

不适用

响应头

Content-Length、Content-Type

响应消息正文

新密码

响应状态

200, 400, 401, 403, 404, 415, 500

表

7-42

启动批量执行的主要特征

说明

启动执行

摘要

PUT /ers/config/guestuser/bulk

请求头

Accept、Authorization、Host

查询字符串

不适用