文档首页/ 统一身份认证服务 IAM/ API参考/ API/ IAM用户管理/ 查询IAM用户所属用户组
更新时间：2025-08-15 GMT+08:00
查看PDF
分享

查询IAM用户所属用户组

功能介绍

该接口可以用于管理员查询IAM用户所属用户组，或IAM用户查询自己所属用户组。

该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：地区和终端节点。

调试

您可以在API Explorer中调试该接口。

URI

GET /v3/users/{user_id}/groups

表1 路径参数

参数

是否必选

参数类型

描述

user_id

是

String

待查询的IAM用户ID，获取方式请参见：获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

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

X-Auth-Token

是

String

管理员查询IAM用户所属用户组：请参见授权项。

IAM用户查询自己所属用户组：URL中user_id所对应IAM用户的token（无需特殊权限）。

响应参数

表3 响应Body参数

参数

参数类型

描述

groups

Array of objects

用户组信息列表。

links

Object

资源链接信息。
表4 groups

参数

参数类型

描述

description

String

用户组描述信息。

id

String

用户组ID。

domain_id

String

用户组所属账号ID。

name

String

用户组名称。

links

Object

用户组的资源链接信息。

create_time

Long

用户组创建时间。
表5 groups.links

参数

参数类型

描述

self

String

资源链接地址。

previous

String

前一邻接资源链接地址，不存在时为null。

next

String

后一邻接资源链接地址，不存在时为null。
表6 links

参数

参数类型

描述

self

String

资源链接地址。

previous

String

前一邻接资源链接地址，不存在时为null。

next

String

后一邻接资源链接地址，不存在时为null。

请求示例

查询IAM用户所属用户组。

GET https://iam.myhuaweicloud.com/v3/users/{user_id}/groups

响应示例

状态码为 200 时:

请求成功。

{
    "groups": [
        {
            "domain_id": "d78cbac186b744899480f25bd0...",
            "create_time": 1578107542861,
            "name": "IAMGroup",
            "description": "",
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb..."
            },
            "id": "07609e7eb200250a3f7dc003cb7..."
        }
    ],
    "links": {
        "next": null,
        "previous": null,
        "self": "https://iam.myhuaweicloud.com/v3/users/076837351e80251c1f0fc003afe43.../groups"
    }
}

返回值

返回值

描述

200

请求成功。

400

参数无效。

401

认证失败。

403

没有操作权限。

404

未找到相应的资源。

405

不允许的方法。

413

资源冲突。

500

内部服务错误。

503

服务不可用。

错误码

无

父主题： IAM用户管理

相关文档