# 查询企业项目关联用户组的权限 - ListRolesForGroupOnEnterpriseProject #### 功能介绍 该接口可用于查询企业项目直接关联用户组的权限 该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：[地区和终端节点](https://developer.huaweicloud.com/endpoint?IAM)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IAM/doc?api=ListRolesForGroupOnEnterpriseProject)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iam/iam_19_0001.html)。 #### URI GET /v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups/{group_id}/roles 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | enterprise_project_id | 是 | String | 待查询企业项目ID。 | | group_id | 是 | String | 待查询用户组ID。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 已认证的拥有iam:permissions:listRolesForGroupOnEnterpriseProject细粒度权限或Security Administrator权限的token。同时要求group_id所属账号的domain_id与Token中的domain_id一致。 | #### 响应参数 **状态码为 200** **时：** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | [roles] | Array of objects | 角色列表。 | 表4roles | 参数 | 参数类型 | 描述 | |:---|:---|:---| | catalog | String | 权限所在目录。 | | display_name | String | 权限展示名称。 | | description | String | 权限的英文描述信息。 | | description_cn | String | 权限的中文描述信息。 | | domain_id | String | 权限所属账号ID。 | | flag | String | 该参数值为fine_grained时，标识此权限为系统内置的策略。 | | id | String | 权限ID。 | | name | String | 权限名称。 | | [policy] | object | 权限具体内容。 | | type | String | 权限的显示模式。 说明： - AX表示在domain层显示。 - XA表示在project层显示。 - AA表示在domain和project层均显示。 - XX表示在domain和project层均不显示。 - 自定义策略的显示模式只能为AX或者XA，不能在domain层和project层都显示（AA），或者在domain层和project层都不显示（XX）。 | 表5roles.policy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | [Depends] | Array of objects | 该权限所依赖的权限。 | | [Statement] | Array of objects | 授权语句，描述权限的具体内容。 | | Version | String | 权限版本号。 说明： - 1.0：系统预置的角色。以服务为粒度，提供有限的服务相关角色用于授权。 - 1.1：策略。IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。 | 表6roles.policy.Depends | 参数 | 参数类型 | 描述 | |:---|:---|:---| | catalog | String | 权限所在目录。 | | display_name | String | 权限展示名。 | 表7roles.policy.Statement | 参数 | 参数类型 | 描述 | |:---|:---|:---| | Action | Array of strings | 授权项，指对资源的具体操作权限。支持的授权项请参考各云服务《API参考》中"权限和授权项"章节。 说明： - 格式为：服务名:资源类型:操作，例：vpc:ports:create。 - 服务名为产品名称，例如ecs、evs和vpc等，服务名仅支持小写。资源类型和操作没有大小写，要求支持通配符号\*，无需罗列全部授权项。 - 当自定义策略为委托自定义策略时，该字段值为：*"Action": \["iam:tokens:assume"\]*。 | | Effect | String | 作用。包含两种：允许（Allow）和拒绝（Deny），既有Allow又有Deny的授权语句时，遵循Deny优先的原则。 枚举值： - Allow - Deny | | Condition | Object | 限制条件。了解更多相关参数，请参考：[配置自定义策略](https://support.huaweicloud.com/usermanual-iam/iam_01_0605.html#section1)。 说明： 以请求示例中的Condition为例：条件键（obs:prefix）和字符串（public）需相等（StringEquals）。 ``` "Condition": { "StringEquals": { "obs:prefix": [ "public" ] } } ``` | | Resource | Object | 资源。规则如下： 说明： - 可填 \* 的五段式：::::，例："obs:*:*:bucket:\*"。 - region字段为\*或用户可访问的region。service必须存在且resource属于对应service。 - 当该自定义策略为委托自定义策略时，该字段类型为Object，值为：*"Resource": {"uri": \["/iam/agencies/agencyTest"\]}*。 | #### 请求示例 查询企业项目关联用户组的权限。 ``` GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups/{group_id}/roles ``` #### 响应示例 **状态码： 200** 请求成功 ``` { "roles" : [ { "catalog" : "CUSTOMED", "description" : "u81eau5b9au4e49u6743u9...", "description_cn" : null, "display_name" : "XpBdkPYCCx", "domain_id" : "0456fd5a278033120f37c006683ab...", "flag" : null, "id" : "5d1b6256331f4fb494534bf240698...", "name" : "custom_policy1", "policy" : { "Statement" : [ { "Action" : [ "aaa:a*b:baa*" ], "Condition" : null, "Effect" : "Deny", "Resource" : null }, { "Action" : [ "aaa:a*b:bab*" ], "Condition" : null, "Effect" : "Allow", "Resource" : null } ], "Version" : "1.1" }, "type" : "XA" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求成功。 | | 400 | 请求参数出错。 | | 401 | 认证失败。 | | 403 | 没有操作权限。 | | 404 | 未找到相应的资源。 | | 415 | Content type校验错误。 | | 500 | 内部系统异常。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-iam/iam_02_0006.html)。