# 查询租户授权信息 - ShowDomainRoleAssignments #### 功能介绍 该接口用于查询指定账号中的授权记录。 该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：[地区和终端节点](https://developer.huaweicloud.com/endpoint?IAM)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IAM/doc?api=ShowDomainRoleAssignments)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iam/iam_19_0001.html)。 #### URI GET /v3.0/OS-PERMISSION/role-assignments 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | domain_id | 是 | String | 待查询账号ID，获取方式请参见：[获取账号、IAM用户、项目、用户组、区域、委托的名称和ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html)。 | | role_id | 否 | String | 策略ID。 | | subject | 否 | String | 授权主体，取值范围：user、group、agency。该参数与subject.user_id、subject.group_id、subject.agency_id只能选择一个。 | | subject.user_id | 否 | String | 授权的IAM用户ID，获取方式请参见：[获取账号、IAM用户、项目、用户组、区域、委托的名称和ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html)。 | | subject.group_id | 否 | String | 授权的用户组ID，获取方式请参见：[获取账号、IAM用户、项目、用户组、区域、委托的名称和ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html)。 | | subject.agency_id | 否 | String | 授权的委托ID，获取方式请参见：[获取账号、IAM用户、项目、用户组、区域、委托的名称和ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html)。 | | scope | 否 | String | 授权范围，取值范围：project、domain、enterprise_project。该参数与scope.project_id、scope.domain_id、scope.enterprise_projects_id只能选择一个。 说明： - 如需查看全局服务授权记录，scope取值domain或填写scope.domain_id。 - 如需查看基于所有资源的授权记录，scope取值为domain，且is_inherited取值为true。 - 如需查看基于项目的授权记录，scope取值为project或填写scope.project_id。 - 如需查看基于企业项目的授权记录，scope取值为enterprise_project或填写scope.enterprise_project_id。 | | scope.project_id | 否 | String | 授权的项目ID，获取方式请参见：[获取账号、IAM用户、项目、用户组、区域、委托的名称和ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html)。 | | scope.domain_id | 否 | String | 待查询账号ID，获取方式请参见：[获取账号、IAM用户、项目、用户组、区域、委托的名称和ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html)。 | | scope.enterprise_projects_id | 否 | String | 授权的企业项目ID，获取方式请参见：[如何获取企业项目ID](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0126101490.html)。 | | is_inherited | 否 | Boolean | 是否包含基于所有项目授权的记录，默认为false。当参数scope=domain或者scope.domain_id存在时生效。true：查询基于所有项目授权的记录。 false：查询基于全局服务授权的记录。 | | include_group | 否 | Boolean | 是否包含基于IAM用户所属用户组授权的记录，默认为true。当参数subject=user或者subject.user_id存在时生效。true：查询基于IAM用户授权、IAM用户所属用户组授权的记录。 false：仅查询基于IAM用户授权的记录。 | | page | 否 | Integer | 分页查询时数据的页数，查询值最小为1。需要与per_page同时存在。 | | per_page | 否 | Integer | 分页查询时每页的数据个数，取值范围为\[1,50\]，需要与page同时存在。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 访问令牌，承载用户的身份、权限等信息。 token所需权限请参见[授权项](https://support.huaweicloud.com/api-iam/iam_19_0001.html#iam_19_0001__section15916295435)。 | #### 响应参数 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total_num | Long | 返回授权记录的总条数。 | | [role_assignments] | Array of RoleAssignmentBody objects | 授权信息。 | 表4role_assignments | 名称 | 类型 | 描述 | |:---|:---|:---| | [user] | RoleUserAssignmentId object | 授权用户信息。仅在授权主体，取值为user时返回此字段。 | | [role] | RoleAssignmentId object | 授权策略信息。 | | [group] | RoleGroupAssignmentId object | 授权用户组信息。仅在授权主体，取值为[group]时返回此字段。 | | [agency] | RoleAgencyAssignmentId object | 授权委托信息。仅在授权主体，取值为agency时返回此字段。 | | [scope] | RoleAssignmentScope object | 授权作用的范围。 | | is_inherited | Boolean | 是否基于所有项目授权。 | 表5role_assignments.user | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | IAM用户ID。 | 表6role_assignments.role | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | 权限ID。 | 表7role_assignments.group | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | 用户组ID。 | 表8role_assignments.agency | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | 委托ID。 | 表9role_assignments.scope | 名称 | 类型 | 描述 | |:---|:---|:---| | [project] | RoleProjectAssignmentId object | 基于IAM项目授权的信息。仅授权范围选择project时返回此字段。 | | [domain] | RoleDomainAssignmentId object | 基于全局服务或所有项目授权的信息。仅授权范围选择domain时返回此字段。 | | [enterprise_project] | RoleEnterpriseProjectAssignmentId object | 基于企业项目授权的信息。仅授权范围选择enterprise_project时返回此字段。 | 表10role_assignments.scope.project | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | IAM项目ID。 | 表11role_assignments.scope.domain | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | 全局服务ID。 | 表12role_assignments.scope.enterprise_project | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | 企业项目ID。 | #### 请求示例 查询租户授权信息。 ``` GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/role-assignments?{domain_id} ``` #### 响应示例 **状态码为200时：** 请求成功。 ``` { "role_assignments":[{ "group":{ "id":"07609e7eb200250a3f7dc003cb7a4e2d" }, "is_inherited":true, "role":{ "id":"11e5c42d20cc349a2b9e2f8afd253f50c" }, "scope":{ "domain":{ "id":"d78cbac186b744899480f25bd022f468" } } }], "total_num":1 } ``` #### 返回值 | 返回值 | 描述 | |:---|:---| | 200 | 请求成功。 | | 400 | 参数无效。 | | 401 | 认证失败。 | | 403 | 没有操作权限。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-iam/iam_02_0006.html)。