# 查询云服务器组列表（废弃） - NovaListServerGroups
#### 功能介绍
查询云服务器组列表。
当前API已废弃，请使用[查询云服务器组列表 - ListServerGroups](https://support.huaweicloud.com/api-ecs/ecs_02_1305.html)。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=NovaListServerGroups)中调试该接口。
#### URI
GET /v2.1/{project_id}/os-server-groups
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                             |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 |
   
可以将如下作为URI参数，过滤查询结果。
使用方式：/v2/{project_id}/os-server-groups?
#### 请求消息
无
#### 响应消息
响应参数如[表2]所示。
 表2响应参数 
| 参数            | 参数类型             | 描述                                                                                |
|:---|:---|:---|
| server_groups | Array of objects | 云服务器组信息，参考[表3]。 |
   
 表3server_groups参数信息 
| 参数         | 参数类型             | 描述                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| id         | String           | 云服务器组UUID。                                                                                                                                                                                                                                                            |
| name       | String           | 云服务器组名称。                                                                                                                                                                                                                                                              |
| members    | Array of strings | 云服务器组中包含的云服务器列表。                                                                                                                                                                                                                                                      |
| metadata   | Object           | 云服务器组元数据。                                                                                                                                                                                                                                                             |
| project_id | String           | 云服务器组所属租户ID，UUID格式。 微版本2.13及以上版本支持。                                                                                                                                                                     |
| policies   | Array of strings | 与云服务器组关联的策略名称列表。包括： - anti-affinity：此组中的云服务器必须安排到不同的主机。   |
| user_id    | String           | 云服务器组所属用户ID。 微版本2.13及以上版本支持。                                                                                                                                                                      |
   
#### 请求示例
查询云服务器组列表。
```
GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/os-server-groups
```
#### 响应示例
```
{
    "server_groups": [
        {
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "name": "test",
            "policies": ["anti-affinity"],
            "members": [],
            "metadata": {},
            "project_id": "9c53a566cb3443ab910cf0daebca90c4"
        }
    ]
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。