管理员查询用户组所包含的IAM用户 - KeystoneListUsersForGroupByAdmin

功能介绍

该接口可以用于管理员查询用户组中所包含的IAM用户。

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v3/groups/{group_id}/users

表1 路径参数
参数	是否必选	参数类型	描述
group_id	是	String	待查询的用户组ID，获取方式请参见：获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	该字段内容填为“application/json;charset=utf8”。
X-Auth-Token	是	String	访问令牌，承载用户的身份、权限等信息。 token所需权限请参见授权项。

响应参数

表3 响应Body参数
参数	参数类型	描述
links	Object	用户组资源的链接。
users	Array of objects	IAM用户信息列表。

表4 links
参数	参数类型	描述
self	String	资源链接地址。
previous	String	前一邻接资源链接地址，不存在时为null。
next	String	后一邻接资源链接地址，不存在时为null。

表5 users
参数	参数类型	描述
name	String	IAM用户名。
links	Object	IAM用户的资源链接信息。
domain_id	String	IAM用户所属账号ID。
enabled	Boolean	用户是否启用。true表示启用，false表示停用，默认为true。
id	String	IAM用户ID。
password_expires_at	String	密码过期时间，“null”表示密码不过期。说明： UTC时间，格式为YYYY-MM-DDTHH:mm:ss.ssssss，日期和时间戳格式如：2023-06-28T08:56:33.710000。
description	String	IAM用户描述信息。
access_mode	String	IAM用户访问方式。 default：默认访问模式，编程访问和管理控制台访问。 programmatic：编程访问。 console：管理控制台访问。
pwd_status	Boolean	IAM用户密码状态。true：需要修改密码，false：不需要修改密码。
last_project_id	String	IAM用户退出华为云前，在控制台最后访问的项目ID，如果用户无访问记录，此字段可能不返回。
pwd_strength	String	IAM用户的密码强度。high：密码强度高；mid：密码强度中等；low：密码强度低。如果用户未设置密码，此字段可能不返回。

表6 users.links
参数	参数类型	描述
self	String	资源链接地址。
previous	String	前一邻接资源链接地址，不存在时为null。
next	String	后一邻接资源链接地址，不存在时为null。

请求示例

管理员查询用户组所包含的IAM用户。

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

响应示例

状态码为 200 时:

请求成功。

{
    "links": {
        "next": null,
        "previous": null,
        "self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb7a4e2d/users"
    },
    "users": [
        {
            "pwd_status": true,
            "domain_id": "d78cbac186b744899480f25bd...",
            "last_project_id": "065a7c66da0010992ff7c0031e...",
             "name": "IAMUserA",
            "description": "--",
            "password_expires_at": null,
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc00375..."
            },
            "id": "07609fb9358010e21f7bc003751c7...",
            "enabled": true
        },
        {
            "pwd_status": true,
            "domain_id": "d78cbac186b744899480f25bd022...",
            "last_project_id": "065a7c66da0010992ff7c0031e5a...",
            "name": "IAMUserB",
            "description": "",
            "password_expires_at": null,
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/users/076837351e80251c1f0fc003af..."
            },
            "id": "076837351e80251c1f0fc003afe43...",
            "enabled": true
        }
    ]
}