文档首页/ 统一身份认证服务 IAM/ API参考（吉隆坡区域）/ API/ 权限管理/ 查询角色列表
更新时间：2024-07-25 GMT+08:00
查看PDF

查询角色列表

功能介绍

该接口提供查询角色列表功能，包括角色中的权限策略，权限通过角色（Role）来表达，一个Role代表成一组action。

URI

GET /v3/roles

表1 Query参数

参数

是否必选

参数类型

描述

domain_id

否

String

账号ID。

说明：
  • 如果填写此参数，则返回账号下所有自定义策略。
  • 如果不填写此参数，则返回所有系统权限（包含系统策略和系统角色）。

name

否

String

系统内部权限名。（非控制台权限展示名“display_name”）

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

该字段内容填为“application/json;charset=utf8”。

X-Auth-Token

是

String

拥有Security Administrator权限的token。

响应参数

表3 响应Body参数

参数

参数类型

描述

links

Object

资源链接信息。

roles

Array of objects

权限信息列表。

total_number

Integer

返回权限的总数。
表4 links

参数

参数类型

描述

self

String

资源链接。

previous

String

上一个临接资源链接。

next

String

下一个临接资源链接。
表5 roles

参数

参数类型

描述

domain_id

String

权限所属账号ID。

flag

String

该参数值为fine_grained时，标识此权限为系统内置的策略。

description_cn

String

权限的中文描述信息。

catalog

String

权限所在目录。

name

String

权限名。携带在用户的token中，云服务根据该名称来判断用户是否有权限访问。

description

String

权限描述信息。

links

Object

权限的资源链接信息。

id

String

权限ID。

display_name

String

权限展示名。

type

String

权限的显示模式。

说明：
  • AX表示在domain层显示。
  • XA表示在project层显示。
  • AA表示在domain和project层均显示。
  • XX表示在domain和project层均不显示。
  • 自定义策略的显示模式只能为AX或者XA，不能在domain层和project层都显示（AA），或者在domain层和project层都不显示（XX）。

policy

Object

权限的具体内容。

updated_time

String

权限更新时间。

created_time

String

权限创建时间。
表6 roles.links

参数

参数类型

描述

self

String

资源链接地址。

previous

String

前一邻接资源链接地址。

next

String

后一邻接资源链接地址。
表7 roles.policy

参数

参数类型

描述

Depends

Array of objects

该权限所依赖的权限。

Statement

Array of objects

授权语句，描述权限的具体内容。

Version

String

权限版本号。

说明：
  • 1.0：系统预置的角色。以服务为粒度，提供有限的服务相关角色用于授权。
  • 1.1：策略。IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。
表8 roles.policy.Depends

参数

参数类型

描述

catalog

String

权限所在目录。

display_name

String

权限展示名。
表9 roles.policy.Statement

参数

参数类型

描述

Action

Array of strings

授权项，指对资源的具体操作权限，不超过100个。

说明：
  • 格式为：服务名:资源类型:操作，例：vpc:ports:create。
  • 服务名为产品名称，例如ecs、evs和vpc等，服务名仅支持小写。 资源类型和操作没有大小写，要求支持通配符号*，无需罗列全部授权项。
  • 当自定义策略为委托自定义策略时，该字段值为： "Action": ["iam:agencies:assume"]。

Effect

String

作用。包含两种：允许（Allow）和拒绝（Deny），既有Allow又有Deny的授权语句时，遵循Deny优先的原则。

取值范围：

  • Allow
  • Deny

Condition

Object

限制条件。不超过10个。

Resource

Array of strings

资源。数组长度不超过10，每个字符串长度不超过128，规则如下：

说明：
  • 可填 * 的五段式：::::，例："obs:::bucket:*"。
  • region字段为*或用户可访问的region。service必须存在且resource属于对应service。
  • 当该自定义策略为委托自定义策略时，该字段类型为Object，值为："Resource": {"uri": ["/iam/agencies/07805acaba800fdd4fbdc00b8f888c7c"]}。
表10 roles.policy.Statement.Condition.operator

参数

参数类型

描述

attribute

Array of strings

条件键。key为与运算符有对应关系的合法属性，value为长度不超过10的字符串数组。

该参数类型为自定义字符串数组。

请求示例

GET https://sample.domain.com/v3/roles

响应示例

状态码为 200 时:

请求成功。

{
  "roles" : [ {
    "domain_id" : null,
    "description_cn" : "漏洞扫描服务（VSS）管理员，拥有该服务下的所有权限",
    "catalog" : "VulnScan",
    "name" : "wscn_adm",
    "description" : "Vulnerability Scan Service administrator of tasks and reports.",
    "links" : {
      "next" : null,
      "previous" : null,
      "self" : "https://sample.domain.com/v3/roles/0af84c1502f447fa9c2fa18083fbb..."
    },
    "id" : "0af84c1502f447fa9c2fa18083fbb...",
    "display_name" : "VSS Administrator",
    "type" : "XA",
    "policy" : {
      "Version" : "1.0",
      "Statement" : [ {
        "Action" : [ "WebScan:*:*" ],
        "Effect" : "Allow"
      } ],
      "Depends" : [ {
        "catalog" : "BASE",
        "display_name" : "Server Administrator"
      }, {
        "catalog" : "BASE",
        "display_name" : "Tenant Guest"
      } ]
    }
  }, {
    "domain_id" : null,
    "flag" : "fine_grained",
    "description_cn" : "微服务引擎服务管理员权限",
    "catalog" : "CSE",
    "name" : "system_all_34",
    "description" : "All permissions of CSE service.",
    "links" : {
      "next" : null,
      "previous" : null,
      "self" : "https://sample.domain.com/v3/roles/0b5ea44ebdc64a24a9c372b2317f7..."
    },
    "id" : "0b5ea44ebdc64a24a9c372b2317f7...",
    "display_name" : "CSE Admin",
    "type" : "XA",
    "policy" : {
      "Version" : "1.1",
      "Statement" : [ {
        "Action" : [ "cse:*:*", "ecs:*:*", "evs:*:*", "vpc:*:*" ],
        "Effect" : "Allow"
      } ]
    }
  } ],
  "links" : {
    "next" : null,
    "previous" : null,
    "self" : "https://sample.domain.com/v3/roles"
  },
  "total_number" : 300
}

状态码

状态码

说明

200

请求成功。

400

参数无效。

401

认证失败。

403

没有操作权限。
父主题： 权限管理