1. 开发集成
  2. /
  3. 标准 Web 应用
  4. /
  5. C#
  6. /

  7. 管理模块

  8. /

  9. 角色管理

  10. /
  11. 创建角色

创建角色

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

通过权限分组内角色 code，创建角色，可以选择权限分组、角色描述等。

请求参数

名称类型必填默认值描述示例值
codestring是-权限分组内角色的唯一标识符。manager
namespacestring否default所属权限分组的 code。default
descriptionstring否-角色描述。this is manager

示例代码


using Authing.CSharp.SDK.Models;
using Authing.CSharp.SDK.Services;
using Authing.CSharp.SDK.Utils;
using Authing.CSharp.SDK.UtilsImpl;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

namespace Example
{
    class Program
    {
      private static ManagementClientOptions options;
      private static string ACCESS_Key_ID = "AUTHING_USERPOOL_ID";
      private static string ACCESS_KEY_SECRET = "AUTHING_USERPOOL_SECRET";

      static void Main(string[] args)
      {
          MainAsync().GetAwaiter().GetResult();
      }

      private static async Task MainAsync()
      {
          options = new ManagementClientOptions()
          {
              AccessKeyId = ACCESS_Key_ID,
              AccessKeySecret = ACCESS_KEY_SECRET,
          };

          ManagementClient managementClient = new ManagementClient(options);
        
          RoleSingleRespDto  result = await managementClient.CreateRole
          (  new CreateRoleDto{                  Code= "manager" ,
                  Namespace= "default" ,
                  Description= "this is manager" ,
            }
          );
        }
    }
}

请求响应

类型： RoleSingleRespDto

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

示例结果：

{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "code": "role1",
    "description": "this is description",
    "namespace": "default"
  }
}

数据结构

RoleDto

名称类型必填描述
codestring是权限分组内角色的唯一标识符。 示例值： role1
descriptionstring是角色描述。 示例值： this is description
namespacestring是所属权限分组的 code。 示例值： default