1.57给一个角色同时添加多个用户/组(不覆盖)

<< Click to Display Table of Contents >>

当前位置:  部署与集成 > WebAPI 

1.57给一个角色同时添加多个用户/组(不覆盖)

复制链接

支持的版本:9.1及以后

请求地址

http://ip:port/bi/api?action=setAuthentication&type=combine&token=xxxx

请求消息

请求参数

请求参数:xmlData(必填)

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

<info>

<authentication>

 <type>role</type>

 <name>test_role</name>

 <users>

<user>

 <name>test1</name>

  </user>

  <user>

 <name>test2</name>

  </user>

 </users>

 <groups>

<group>

 <name>管理组-1</name>

 <parent>管理组</parent>

</group>

<group>

 <name>测试组</name>

 <parent>测试组1/测试组2</parent>

</group>

 </groups>

</authentication>

</info>

参数描述

authentication-type(必填):需要设置的节点类型,只有一个选项:role。

authentication-name(必填):需要设置节点的名称。

users(选填):需要给角色添加用户。

users-user-name(添加用户时必填):需要添加用户的名称。

groups(选填):需要给角色添加组。

groups-group-name(添加分组时必填):需要添加分组的名称。

groups-group-parent(添加分组时选填):需要添加分组的路径。

说明:

users、groups至少选填一项。

此方法不会覆盖原有的用户/组,在原有的基础上新增用户/组。

示例

function setAuthentication() {

       var xml = getXml();

       $.post("http://" + ip + ":" + port + "/" + project + "/api?action=setAuthentication&type=combine&token=xxxx",

          {xmlData : xml},

          function(result) {        

             writeXml(result);

          });

    }

响应消息

响应结果

操作成功

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

<results>

 <result>

        <level>1</level>

        <message>操作成功。</message>

 </result>

</results>

操作失败

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

<results>

<result>

 <level>6</level>

 <message>安全设置中包含不存在的用户、组或角色:test1</message>

</result>

</results>

结果描述

响应结果信息为xml,直接parse即可。

level 返回类型,不同数值代表不同返回状态,见附录

message为接口操作结果信息。