¶ 获取角色列表

更新时间: 2024-10-10 07:28:40

获取角色列表，支持分页。

¶ 请求参数

名称	类型	必填	默认值	描述	示例值
namespace	string	否	default	所属权限分组的 code。	`default`
page	number	否	1	当前页数，从 1 开始。	`1`
limit	number	否	10	每页数目，最大不能超过 50，默认为 10。	`10`

¶ 示例代码


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);
        
          RolePaginatedRespDto  result = await managementClient.ListRoles
          (             
                nameSpace: "default", 
                page: 1, 
                limit: 10
          );
        }
    }
}

¶ 请求响应

类型： RolePaginatedRespDto

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

示例结果：

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

¶ 数据结构

¶ RolePagingDto

名称	类型	必填	描述
totalCount	number	是	记录总数。
list	array	是	响应数据。嵌套类型：RoleDto。

¶ RoleDto

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