统一身份认证服务 IAM-查询权限列表:URI

时间：2025-02-12 15:14:21

URI

GET /v3/roles

表1 Query参数
参数	是否必选	参数类型	描述
domain_id	否	String	账号ID，获取方式请参见：获取账号、 IAM 用户、项目、用户组、区域、委托的名称和ID。说明：如果填写此参数，则返回账号下所有自定义策略。如果不填写此参数，则返回所有系统权限（包含系统策略和系统角色）。
permission_type	否	String	区分系统权限类型的参数。当domain_id参数为空时生效。 policy：返回系统策略 role：返回系统角色。
name	否	String	系统内部呈现的权限名称。如云目录服务C CS 普通用户权限CCS User的name为ccs_user。建议您传参display_name，不传name参数。
display_name	否	String	权限名称或过滤条件。该参数可以传入控制台或系统权限显示的权限名称。权限名称：如传参为ECS FullAccess，则返回该权限相关信息。过滤条件：如传参为Administrator，则返回满足条件的所有管理员权限。
page	否	Integer	分页查询时数据的页数，查询值最小为1。需要与per_page同时存在。传入domain_id参数查询自定义策略时，可配套使用。
per_page	否	Integer	分页查询时每页的数据个数，取值范围为[1,300]，默认值为300。需要与page同时存在。不传page和per_page参数时，每页最多返回300个权限。
type	否	String	过滤权限的显示模式。取值范围：domain，project，all。type为domain时，返回type=AA或AX的权限；type为project时，返回type=AA或XA的权限；type为all时返回type为AA、AX、XA的权限。说明： AX表示在domain层显示。 XA表示在project层显示。 AA表示在domain和project层均显示。 XX表示在domain和project层均不显示。
catalog	否	String	权限所在目录。catalog值精确匹配策略的catalog字段(可以过滤服务的策略、或者自定义策略)。