
# 查询录制列表 - SearchRecordings
#### 描述
该接口用于查询会议录制列表。管理员可以查询本企业内所有的录制，普通用户仅能查询自己创建的会议的录制。不带查询参数时，默认查询权限范围内的录制。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Meeting&api=SearchRecordings)中调试该接口。
#### URI
GET /v1/mmc/management/record/files
#### 请求参数
表1参数说明 
| 参数                   | 是否必须 | 类型      | 位置     | 描述                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|:---|
| userUUID             | 否    | String  | Query  | 用户的UUID。 说明： 仅管理员有权限查询本企业其他用户的会议录制；普通账号该字段无效，只能查询自己的。                                                                                                                                                                                                                                                  |
| offset               | 否    | Integer | Query  | 查询偏移量。默认为0。                                                                                                                                                                                                                                                                                                                                                                            |
| limit                | 否    | Integer | Query  | 查询数量。默认是20，最大500条。                                                                                                                                                                                                                                                                                                                                                                     |
| queryAll             | 否    | Boolean | Query  | 是否查询企业下所有用户的会议录制。 - true：查询所有用户的会议录制  - false：仅查询管理员自己的会议录制 说明： 仅对企业管理员生效。    |
| searchKey            | 否    | String  | Query  | 查询条件。会议主题、会议预约人和会议ID等可作为搜索内容。                                                                                                                                                                                                                                                                                                                                                          |
| startDate            | 是    | long    | Query  | 查询的起始时间戳（单位毫秒）。                                                                                                                                                                                                                                                                                                                                                                        |
| endDate              | 是    | long    | Query  | 查询的截止时间戳（单位毫秒）。                                                                                                                                                                                                                                                                                                                                                                        |
| sortType             | 否    | String  | Query  | 查询结果排序类型。 - ASC_StartTIME：按录制开始时间升序排序  - DSC_StartTIME：按录制开始时间降序排序                                                        |
| X-Access-Token       | 是    | String  | Header | 授权令牌。获取"[执行App ID鉴权](https://support.huaweicloud.com/api-meeting/meeting_21_0311.html)"响应的accessToken。                                                                                                                                                                                                                                                                                 |
| X-Authorization-Type | 否    | String  | Header | 标识是否为第三方portal过来的请求。 说明： 该参数将废弃，请勿使用。                                                                                                                                                                                                                                                                |
| X-Site-Id            | 否    | String  | Header | 用于区分到哪个HCSO站点鉴权。 说明： 该参数将废弃，请勿使用。                                                                                                                                                                                                                                                                    |
   
#### 状态码
表2状态码说明 
| HTTP状态码 | 描述        |
|:---|:---|
| 200     | 操作成功。     |
| 400     | 参数异常。     |
| 401     | 未鉴权或鉴权失败。 |
| 403     | 权限受限。     |
| 500     | 服务端异常。    |
   
#### 响应参数
表3响应参数 
| **参数** | 类型                                                                             | 描述      |
|:---|:---|:---|
| offset | Integer                                                                        | 查询偏移量。  |
| limit  | Integer                                                                        | 每页的记录数。 |
| count  | Integer                                                                        | 总记录数。   |
| data   | Array of [RecordFileInfo] objects | 录播文件列表。 |
   
 表4RecordFileInfo 数据结构 
| 参数             | 类型         | 描述                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| confUUID       | String     | 会议UUID。                                                                                                                                                                                                                                                                                                                                                                                                                       |
| confID         | String     | 会议ID。                                                                                                                                                                                                                                                                                                                                                                                                                         |
| url            | String\[\] | 录播观看地址。                                                                                                                                                                                                                                                                                                                                                                                                                       |
| rcdTime        | Integer    | 录制时长（单位秒）。                                                                                                                                                                                                                                                                                                                                                                                                                    |
| rcdSize        | Integer    | 录制文件大小（MB）。                                                                                                                                                                                                                                                                                                                                                                                                                   |
| subject        | String     | 会议主题。                                                                                                                                                                                                                                                                                                                                                                                                                         |
| scheduserName  | String     | 会议预订者名称。                                                                                                                                                                                                                                                                                                                                                                                                                      |
| startTime      | String     | 会议开始时间。                                                                                                                                                                                                                                                                                                                                                                                                                       |
| isDecodeFinish | Boolean    | 录制文件是否转码完成。                                                                                                                                                                                                                                                                                                                                                                                                                   |
| decodeEndTime  | long       | 录制文件预计转码完成时间。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| available      | Boolean    | 录播文件是否可观看。                                                                                                                                                                                                                                                                                                                                                                                                                    |
| recordAuthType | Integer    | 录播观看鉴权方式，在录播类型为:录播、直播+录播时有效。 - 0：可通过链接观看/下载  - 1：企业用户可观看/下载  - 2：与会者可观看/下载   |
   
#### 请求消息示例
```
GET /v1/mmc/management/record/files?startDate=1574092800000&endDate=1576771199999
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
user-agent: WeLink-desktop
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
```
#### 响应消息示例
```
HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 683
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 25b89efb63970d80e715503650157098
Server: api-gateway
X-Request-Id: a9af536f02e45c516513a8248bfe04c3
{
    "offset": 0,
    "limit": 20,
    "count": 1,
    "data": [
        {
            "confUUID": "51adf610220411eaaae03f22d33cc26b",
            "confID": "912049654",
            "url": [
                "https://114.116.237.2/rse/rse/html/play/Mediaxplay.html?rseid=00030&recordId=000301fa-0512-412f-b363-cb9f76063628&token=24e4f6d9850a42365783c88ceb36701bb87f5393a595af82&confID=51adf610220411eaaae03f22d33cc26b&isSecure=true"
            ],
            "rcdTime": 71,
            "rcdSize": 0,
            "subject": "user8002的会议",
            "scheduserName": "user8002",
            "startTime": "2019-12-19 02:07",
            "isDecodeFinish": false,
            "decodeEndTime": 1576721412885,
            "available": true,
            "recordAuthType":2
        }
    ]
}
```
#### 错误码
当您使用华为云会议服务端API时，如果遇到"MMC"或者"USG"开头的错误码，请参考[华为云API错误中心](https://apierrorcenter.developer.huaweicloud.com/apierrorcenter/errorcode?product=Meeting)。
#### CURL命令示例
```
curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' 'https://api.meeting.huaweicloud.com/v1/mmc/management/record/files?startDate=1574092800000&endDate=1576771199999'
```
