1.56 给一个角色同时添加多个用户/组,保留该角色原来的用户/组

<< Click to Display Table of Contents >>

当前位置:  系统集成 > WebAPI 

1.56 给一个角色同时添加多个用户/组,保留该角色原来的用户/组

Previous pageReturn to chapter overviewNext page

版本: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>

参数描述

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

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

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

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

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

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

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

说明:

1)users、groups至少选填一项。

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

示例

function setAuthentication() {

        var xml = getXml();

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

           {xmlData : xml},

           function(result) {        

              writeXml(result);

           });

     }

响应消息

响应结果

1)操作成功

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

<results>

  <result>

         <level>1</level>

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

  </result>

</results>

2)操作失败

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

<results>

 <result>

  <level>6</level>

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

 </result>

</results>

结果描述

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

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

2)message为接口操作结果信息。