Querying User Group Details
Function
This API is provided for the administrator to query user group information.
The API can be called using both the global endpoint and region-specific endpoints.
Authorization Information
Each account is authorized to call all APIs, but its IAM users must obtain the required permissions. For details, see Permissions and Supported Actions.
URI
GET /v3/groups/{group_id}
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 | Access token issued to a user to bear its identity and permissions. For details about the permissions required by the token, see Actions. |
Response Parameters
Parameter | Type | Description |
|---|---|---|
Object | User group information. |
Example Request
Request for querying user group details
GET https://iam.myhuaweicloud.eu/v3/groups/{group_id} Example Response
Status code: 200
The request is successful.
{
"group": {
"domain_id": "d78cbac186b744899480f25bd02...",
"create_time": 1578107542861,
"name": "IAMGroup",
"description": "",
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.eu/v3/groups/07609e7eb200250a3f7dc003cb7a..."
},
"id": "07609e7eb200250a3f7dc003cb7..."
}
} Status Codes
Status Code | Description |
|---|---|
200 | The request is successful. |
400 | Invalid parameters. |
401 | Authentication failed. |
403 | Access denied. |
404 | The requested resource cannot be found. |
Error Codes
None
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.
