1.17 设置权限(不会覆盖之前的权限设置)

<< Click to Display Table of Contents >>

当前位置:  系统集成 > WebAPI 

1.17 设置权限(不会覆盖之前的权限设置)

Previous pageReturn to chapter overviewNext page

请求地址

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

请求消息

请求参数

请求参数:xmlData(必填)

V9.3版本支持给多个资源批量设置权限:

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

<info>

 <perm>

   <refs>

     <ref><type>Conn</type><path>test</path></ref>

     <ref><type>Query</type></ref>

     <ref><type>Editor</type></ref>        

     <ref><type>db</type><path>93/更多排序</path></ref>

     <ref><type>db</type><path>93/编辑模</path></ref>

    </refs>    

    <rperm>

      <r><type>user</type><name>test2_groupadmin</name></r>

       <r><type>group</type><name>ssas</name></r>

       <r><type>role</type><name>everyone_role</name></r>

    </rperm>

 

    <wperm>

      <w><type>user</type><name>test2_groupadmin</name></w>

      <w><type>user</type><name>yhuser</name></w>

      <w><type>user</type><name>Ink</name></w>

   </wperm>

</perm>

</info>

给操作设置权限:

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

<info>

  <perm>

     <ref><type>Query</type></ref>

     <rperm>

        <r><type>user</type><name>u2</name></r>

     </rperm>

  </perm>

</info>

 

参数描述

参数为节点信息:

1)ref(必填):为要设置的节点

2)refs-ref-type(必填):为要设置的节点类型,包括资源类型和操作类型(见附录)。

3)refs-ref-path(选填):要设置的节点路径,选择资源类型时,ref-path必须填写;选择操作类型时,ref-path不用填写。

4)refs-rperm(选填):读权限

5)refs-rperm-r-type(设置读权限时必填):可读取这个节点的类型,包括三种:user,group,role。

6)refs-rperm-r-name(设置读权限时必填):可读取这个节点的用户、组或者角色的名称。

7)refs-rperm-r-parent(选填):可读取这个节点的组的路径。

8)refs-wperm(选填):写权限

9)refs-wperm-w-type(设置写权限时必填):可编辑这个节点的类型,包括三种:user,group,role。

10) refs-wperm-w-name(设置写权限时必填):可编辑这个节点的用户,组,或者角色的名称。

11)refs- wperm-w-parent(选填):可编辑这个节点的组的路径。

说明:

1) rperm,wperm 至少选填一项,且都可能包含多个子节点。

2) 操作不能设置写权限。

3) 此方法不会覆盖掉之前的权限设置。

示例

function setPermission() {

  var xml = getXml();

  $.post("http://" + ip + ":" + port + "/" + project + "/api?action=setPermission&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>

多个资源:

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

<results>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>1</level>

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

   </result>

</results>

2) 操作失败

单个资源/单个操作:

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

<results>

  <result>

     <level>6</level>

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

  </result>

</results>

多个资源:

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

<results>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>1</level>

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

   </result>

   <result>

       <level>6</level>

       <message>资源或操作“93/编辑模”找不到。</message>

   </result>

</results>

结果描述

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

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

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