¶ 批量创建角色

更新时间: 2025-08-20 12:33:28

批量创建角色，可以选择权限分组、角色描述等。

¶ 请求参数

名称	类型	必填	默认值	描述	示例值
list	RoleListItem[]	是	-	角色列表。	`[{"code":"my-role-code","namespace":"default","description":"this is description"}]`

¶ 示例代码

import { ManagementClient } from 'authing-node-sdk';
// 在 Node.js 中引用：
// const { ManagementClient } = require('authing-node-sdk');

const managementClient = new ManagementClient({
  accessKeyId: 'AUTHING_USERPOOL_ID',
  accessKeySecret: 'AUTHING_USERPOOL_SECRET',
});

(async () => {
  const result = await managementClient.createRolesBatch({
    list: [{
            code: 'my-role-code',
          description: 'this is a description about the role',
          namespace: 'default',
      }],
 });
})();

¶ 请求响应

类型： IsSuccessRespDto

名称	类型	描述
statusCode	number	业务状态码，可以通过此状态码判断操作是否成功，200 表示成功。
message	string	描述信息
apiCode	number	细分错误码，可通过此错误码得到具体的错误类型。
data	IsSuccessDto	操作是否成功

示例结果：

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

¶ 数据结构

¶ RoleListItem

名称	类型	必填	描述
code	string	是	权限分组内角色的唯一标识符。示例值： `my-role-code`
description	string	否	角色描述。示例值： `this is a description about the role`
namespace	string	否	所属权限分组的 code。示例值： `default`

¶ IsSuccessDto

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