Querying User Groups Associated with an Enterprise Project

Function

This API is used to query the user groups directly associated with a specified enterprise project.

The API can be called using both the global endpoint and region-specific endpoints. For IAM endpoints, see Regions and Endpoints.

Debugging

You can debug this API in API Explorer.

URI

GET /v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	Yes	String	ID of the enterprise project for querying the permissions of an associated user group.

Request Parameters

**Table 2** Parameters in the request header
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Authenticated token with iam:permissions:listGroupsOnEnterpriseProject or Security Administrator permission. The domain_id of the account which the enterprise_project_id belongs to must be the same as the domain_id in the token.

Response Parameters

Status code: 200

**Table 3** Parameters in the response body
Parameter	Type	Description
groups	Array of objects	User group information.

**Table 4** groups
Parameter	Type	Description
createTime	Integer	Time when the user group was created.
description	String	User group description.
domainId	String	Account ID.
id	String	User group ID.
name	String	User group name.

Example Request

Request for querying user groups associated with an enterprise project

GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups

Example Response

Status code: 200

The request is successful.

{ 
  "groups" : [ { 
    "createTime" : 1552093271000, 
    "description" : null, 
    "domainId" : "dc7f62ae236c47b8836014c16d64d...", 
    "id" : "e6bde2403bda43e2813a1a6848963...", 
    "name" : "auth" 
  } ] 
}

Status Codes

Status Code	Description
200	The request is successful.
400	Parameter error.
401	Authentication failed.
403	Access denied.
404	The requested resource cannot be found.
415	Incorrect Content-Type.
500	A system error occurred.