1. Development Integration
  2. /
  3. Standard Web Application
  4. /
  5. Node.js
  6. /

  7. Management Module

  8. /

  9. Role Management

  10. /
  11. Assign Role

分配角色

Update time: 2025-07-23 07:34:21
Edit

通过权限分组内角色 code，分配角色，被分配者可以是用户或部门。

请求参数

名称类型必填默认值描述示例值
targetsTargetDto[]是-目标对象。[{"targetIdentifier":"60b49eb83fd80adb96f26e68","targetType":"USER"}]
codestring是-权限分组内角色的唯一标识符。code1
namespacestring否-所属权限分组的 code。60b49eb83fd80adb96f26e68

示例代码

import { ManagementClient } from "@genauth/nodejs";
// 在 Node.js 中引用：
// const { ManagementClient } = require('@genauth/nodejs');

const managementClient = new ManagementClient({
  accessKeyId: "GEN_AUTH_USERPOOL_ID",
  accessKeySecret: "GEN_AUTH_USERPOOL_SECRET",
});

(async () => {
  const result = await managementClient.assignRole({
    code: "code1",
    namespace: "60b49eb83fd80adb96f26e68",
    targets: [
      {
        targetType: "DEPARTMENT",
        targetIdentifier: "60b49eb83fd80adb96f26e68",
      },
    ],
  });
})();

请求响应

类型： IsSuccessRespDto

名称类型描述
statusCodenumber业务状态码，可以通过此状态码判断操作是否成功，200 表示成功。
messagestring描述信息
apiCodenumber细分错误码，可通过此错误码得到具体的错误类型。
dataIsSuccessDto操作是否成功

示例结果：

{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "success": true
  }
}

数据结构

TargetDto

名称类型必填描述
targetTypestring是目标类型，接受用户，部门。 枚举值：USER,ROLE,GROUP,DEPARTMENT
targetIdentifierstring是目标的 ID。 示例值： 60b49eb83fd80adb96f26e68

IsSuccessDto

名称类型必填描述
successboolean是操作是否成功。 示例值： true