# 查询企业群组空间列表信息 - GetGroupSpaceList
#### 功能介绍
查询企业群组空间列表信息（仅租户管理员有调用该接口的权限）。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/space/groupList
表1Query参数 
| 参数      | 是否必选 | 参数类型    | 描述                               |
|:---|:---|:---|:---|
| offset  | 是    | Integer | 偏移量，最小值为0                        |
| limit   | 是    | Integer | 最大返回个数。最小值为1，最大值为100             |
| keyWord | 否    | String  | 搜索的关键字，可用name和ownerName作为关键字搜索条件 |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                            |
|:---|:---|:---|:---|
| Authorization | 是    | String | 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} |
| X-Traceid     | 否    | String | 消息日志跟踪标识（必须58位）                                                                                                                                               |
| language      | 否    | String | 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语                                                                                                            |
| X-User-Id     | 是    | String | 用户id，用于app鉴权                                                                                                                                                  |
| X-Date        | 是    | String | 日期，用于app鉴权                                                                                                                                                    |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数               | 参数类型                                                                           | 描述     |
|:---|:---|:---|
| code             | Integer                                                                        | 错误码    |
| msg              | String                                                                         | 错误信息   |
| total            | Integer                                                                        | 总数     |
| groupsTotal      | Integer                                                                        | 群组总数   |
| groupsMax        | Integer                                                                        | 最大群组数  |
| assignedCapacity | String                                                                         | 已分配容量  |
| maxCapacity      | String                                                                         | 最大容量   |
| groups           | Array of [GroupSpaceInfo] objects | 群组空间信息 |
   
 表4GroupSpaceInfo 
| 参数            | 参数类型    | 描述                   |
|:---|:---|:---|
| id            | String  | 空间所属的部门ID、用户组ID或群组ID |
| status        | Integer | 空间状态                 |
| capacity      | Integer | 空间大小                 |
| spaceUsed     | String  | 已用空间大小               |
| containerId   | String  | 云空间标识                |
| userNum       | Integer | 用户数                  |
| ownerId       | String  | 拥有者ID                |
| ownerName     | String  | 拥有者名称                |
| tenantId      | String  | 租户标识                 |
| creator       | String  | 创建者                  |
| createTime    | String  | 创建时间                 |
| modifier      | String  | 修改者id                |
| updateTime    | String  | 更新时间                 |
| bizRootFileId | String  | 云空间根目录id             |
| bizSboxFileId | String  | 云空间保险箱目录id           |
| iconUrl       | String  | 图标链接                 |
| name          | String  | 空间名称                 |
   
#### 请求示例
查询本企业的群组空间列表信息。
```
GET  /koodrive/ose/v1/space/groupList?offset=0&limit=10 
Authorization:Bearer+10f88**********4791e9ff
```
#### 响应示例
**状态码：200**
群组空间列表信息。
```
{
    "total": 1,
    "groupsTotal": 1,
    "groupsMax": 500,
    "assignedCapacity": 100,
    "maxCapacity": 2048,
    "groups": [
        {
            "tenantId": "cad444830661464d9da88784a96d960c",
            "creator": "1410172329509745795",
            "createTime": "2024-05-10T01:46:22.000Z",
            "modifier": "1410172329509745795",
            "updateTime": "2024-05-10T02:27:23.000Z",
            "ownerId": "1410172329509745795",
            "status": 0,
            "capacity": 20,
            "spaceUsed": 0,
            "containerId": "IAAE49hOR8LulgAAA1417956457328121729",
            "bizRootFileId": "DE5Hwu6WAAAArootIAAE49hOR8LulgAAA1417956457328121729",
            "bizSboxFileId": "DE5Hwu6WAAAAsboxIAAE49hOR8LulgAAA1417956457328121729",
            "id": "1417956457311344513",
            "groupName": "api01",
            "iconUrl": "1",
            "ownerName": "hid99522477",
            "userNum": 1
        },
  "code" : 0, 
  "msg" : "成功" 
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | 群组空间列表信息。 |