# 查询企业项目关联的用户组
#### 功能介绍
该接口用于查询指定ID的企业项目所关联的用户组。
![](https://support.huaweicloud.com/api-iam/public_sys-resources/note_3.0-zh-cn.png)
根据产品迭代计划，该接口将逐步下线，推荐您使用[查询企业项目关联的用户组 - ListGroupsForEnterpriseProject](https://support.huaweicloud.com/api-iam/iam_02_0518.html)。
#### URI
- URI格式 GET /v3.0/OS-PAP/enterprise-projects/{enterprise_project_id}/groups
  
- URI参数说明
  
  | 属性                    | 是否必选 | 类型     | 说明           |
  |:---|:---|:---|:---|
  | enterprise_project_id | 是    | String | 待查询的企业项目的ID。 |
     
  
 
#### 请求
- Request Header参数说明
  
  | 参数           | 是否必选 | 类型     | 说明                                     |
  |:---|:---|:---|:---|
  | X-Auth-Token | 是    | String | 已认证的拥有Security Administrator权限的token。  |
  | Content-Type | 是    | String | 该字段内容填为"application/json;charset=utf8" |
     
  

- 请求样例
  ```
  curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X GET https://iam.myhuaweicloud.com/v3.0/OS-PAP/enterprise-projects/535fb147-6148-4c71-a679-b79a2cb0ee5d/groups
  ```
  
 
#### 响应
- Response Body参数说明
  
  | 参数     | 是否必选 | 类型    | 说明            |
  |:---|:---|:---|:---|
  | groups | 是    | Array | 企业项目关联的用户组详情。 |
     
  

- groups格式说明
  
  | 参数         | 是否必选 | 类型     | 说明                     |
  |:---|:---|:---|:---|
  | group_id   | 是    | String | 关联用户组的ID。              |
  | group_name | 是    | String | 关联用户组的名称。              |
  | group_desc | 是    | String | 关联用户组的描述。              |
  | user_num   | 是    | Int    | 关联用户组中的用户数。            |
  | policy_num | 是    | Int    | 关联用户组的策略数。             |
  | created_at | 是    | Int    | 关联用户组创建的时间（Unix时间：毫秒）。 |
     
  
- 响应样例：查询的企业项目关联了用户组。
  ```
  {
      "groups": [
          {
              "group_id": "758b99fa1fa24ec4a297d44e092bd...",
              "group_name": "Test",
              "group_desc": "Test",
              "user_num": 4,
              "policy_num": 1,
              "created_at": 1549088526...
          }
      ]
  }
  ```
  
 
- 查询的企业项目没有关联任何用户组，返回的响应体中"groups"的内容为空。
  ```
  {
    "groups": []
  }
  ```
  
#### 状态码
| 状态码 | 说明     |
|:---|:---|
| 200 | 请求成功。  |
| 400 | 参数无效。  |
| 401 | 认证失败。  |
| 403 | 鉴权失败。  |
| 404 | 找不到资源。 |