Querying the IAM Users in a Group
Function
This API can be used by the administrator to query the IAM users in a user group.
The API can be called using both the global endpoint and region-specific endpoints. For IAM endpoints, see Regions and Endpoints.
URI
GET /v3/groups/{group_id}/users
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| group_id | Yes | String | User group ID. For details about how to obtain a user group ID, see Obtaining Account, IAM User, Group, Project, Region, and Agency Information. |
Request Parameters
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| Content-Type | Yes | String | Fill application/json;charset=utf8 in this field. |
| X-Auth-Token | Yes | String | Token with Security Administrator permissions. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| Object | User group resource link. | |
| Array of objects | IAM user information. |
| Parameter | Type | Description |
|---|---|---|
| self | String | Resource link. |
| previous | String | Previous resource link. |
| next | String | Next resource link. |
| Parameter | Type | Description |
|---|---|---|
| name | String | IAM user name. |
| Object | IAM user resource link information. | |
| domain_id | String | ID of the account to which the IAM user belongs. |
| enabled | Boolean | Enabling status of the IAM user. true (default value) indicates that the user is enabled. false indicates that the user is disabled. |
| id | String | IAM user ID. |
| password_expires_at | String | UTC time when the password will expire. null indicates that the password has unlimited validity. |
| description | String | Description of the IAM user. |
| pwd_status | Boolean | Password status. true means that the password needs to be changed, and false means that the password is normal. |
| last_project_id | String | ID of the project that the IAM user lastly accessed before exiting the system. |
| pwd_strength | String | Password strength. The value can be high, mid, or low. |
| object | Other information about the IAM user. |
| Parameter | Type | Description |
|---|---|---|
| description | string | Description of the IAM user. |
| last_project_id | string | ID of the project that the IAM user lastly accessed before exiting the system. |
| pwd_status | boolean | Password status. true means that the password needs to be changed, and false means that the password is normal. |
Example Request
GET https://iam.myhuaweicloud.com/v3/groups/{group_id}/users Example Response
Status code: 200
The request is successful.
{
"links": {
"next": null,
"previous": null,
"self": "https://iam.huaweicloud.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.huaweicloud.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.huaweicloud.com/v3/users/076837351e80251c1f0fc003af..."
},
"id": "076837351e80251c1f0fc003afe43...",
"enabled": true
}
]
} Status Codes
| Status Code | Description |
|---|---|
| 200 | The request is successful. |
| 400 | Invalid parameters. |
| 401 | Invalid parameters. |
| 403 | Access denied. |
| 404 | The requested resource cannot be found. |
Error Codes
None
Last Article: Querying the User Groups to Which an IAM User Belongs
Next Article: Creating an IAM User (Recommended)
Did this article solve your problem?
Thank you for your score！Your feedback would help us improve the website.