Update Role Permission


为角色分配或移除某一应用关联的菜单组、权限点或可见组织结构。

前提条件


应用需拥有“编辑本 OU 内的所有角色”的权限。如有需要,联系 OU 管理员获取权限。

请求格式


POST https://{apigw-address}/app-portal-service/v2.3/role/app/resource/assign

请求参数(URI)


名称

位置(Path/Query)

必需/可选

数据类型

描述

orgId

Query

必需

String

OU ID。如何获取 orgId 信息 >>

请求参数(Body)


名称

必需/可选

数据类型

描述

roleId

必需

String

角色 ID。

appId

必需

String

应用的 Access Key。如何获取 Access Key >>

resourceType

必需

Integer

权限类型。支持以下赋值:

  • 0 表示菜单组。

  • 1 表示权限点。

  • 2 表示可见组织结构。

operationType

必需

Integer

操作类型。支持以下赋值:

  • 0 代表分配。

  • 1 代表移除。

resourceIds

必需

Array

菜单组 ID,可见组织结构 ID,或权限点 ID 列表。

响应参数


名称

数据类型

描述

data

Boolean

角色权限是否更新成功。true 表示成功,false 表示失败。

错误码


代码

描述

31400

可能原因如下:

  • OU ID、角色 ID 或应用 ID 为空。

  • 权限类型为空或无效。

  • 操作类型为空或无效。

  • 菜单组 ID,可见组织结构 ID,或权限点 ID 为空或无效。

31403

可能原因如下:

  • 服务账号无权编辑角色。

  • 角色、菜单组、权限点或可见组织结构不存在。

31404

OU 无权访问应用。

示例

请求示例


url: https://{apigw-address}/app-portal-service/v2.3/role/app/resource/assign
method: POST
{
    "roleId": "your_role_id",
    "appId": "your_access_key",
    "resourceType": 0,
    "operationType": 1,
    "resourceIds": ["your_resource_id"]
}

返回示例


{
  "code": 0,
  "message": "OK",
  "data": true
}