查询IAM用户所属用户组 - KeystoneListGroupsForUser

功能介绍

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

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，只有在该IAM用户查询自己所属用户组时无需授权，否则该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

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	服务不可用。