华为云用户手册

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 1329 Connection: keep-alive Pragma: No-cache Cache-Control: no-cache Server: api-gateway X-Request-Id: 21facce44sd8efa02329afd189da7f3d { "count": 1, "data": [ { "createTime": 1593538236711, "endTime": 253402271999000, "id": "2baafa7ffef04c62a3c3f79f9f8a1a3a", "lastUpdatedBy": "", "publishName": "cCu78RV8Ai", "publishScope": "", "publishStatus": "PUBLISHING", "startTime": 0, "updateTime": 1593538236711 } ], "limit": 10, "offset": 0 }

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 offset 否 Integer Query 查询偏移量，若超过最大数量，则返回最后一页。 默认值：0 limit 否 Integer Query 查询数量。 默认值：10 searchKey 否 String Query 搜索条件，支持名称模糊搜索。 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Request-Id 否 String Header 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。 Accept-Language 否 String Header 语言参数，默认为中文zh-CN，英文为en-US。

请求示例 PUT https://{endpoint}/v1/mmc/control/conferences/interpreterGroup?conferenceID=984178192 { "interpreterGroups": [{ "groupID": "f89d1070afdc41ff1c6496e3f58ccee0", "firstLanguage": "zh", "secondLanguage": "en", "interpreters": [{ "loginAccount": "p-80852a66fca94c69aa3d344ec9452171" }] }] }

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 conferenceID 是 String Query 会议ID。 X-Conference-Authorization 是 String Header 会控Token，通过获取会控token接口获得。 lockSharing 否 Integer Body 锁定共享： 0：不锁定 1：锁定 callInRestriction 否 Integer Body 允许呼入的范围。 0：所有用户 2：企业内用户 3：被邀请用户

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 39 Connection: keep-alive Expires: 0 Pragma: No-cache Cache-Control: no-cache http_proxy_id: 571b4dfceff545fae29aa14cea761079 Server: api-gateway X-Request-Id: f78b007ec2dabf1498620131c7bc19e0

请求消息示例 PUT /v1/mmc/control/conferences/updateStartedConfConfig?conferenceID=900244663 Connection: keep-alive content-type: application/json user-agent: WeLink -desktop Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "lockSharing": 0 }

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 472 Connection: keep-alive Expires: 0 Pragma: No-cache Cache-Control: no-cache http_proxy_id: 2f3aa1fe64f6784b1eb6f75a67ef2b9d Server: api-gateway X-Request-Id: ba03d2ae3b805d8c545c83494c862b48 { "data": [ { "operateTime": 1574119913464, "operateSource": "MCU", "operator": "MCU", "operateCode": "启动声控", "operateResult": "成功" }, { "operateTime": 1574119917864, "operateSource": "Conference System", "operator": "Conference System", "operateCode": "呼叫与会方", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" }, { "operateTime": 1574119917870, "operateSource": "MCU", "operator": "MCU", "operateCode": "关闭与会方麦克风", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" }, { "operateTime": 1574119918064, "operateSource": "MCU", "operator": "MCU", "operateCode": "打开与会方麦克风", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" }, { "operateTime": 1574119917889, "operateSource": "Conference System", "operator": "Conference System", "operateCode": "设置主持人", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" }, { "operateTime": 1574119932913, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "添加与会方", "operationObject": "**********905", "operateResult": "成功" }, { "operateTime": 1574119935460, "operateSource": "Conference System", "operator": "Conference System", "operateCode": "呼叫与会方", "operationObject": "a5db36ce0a5b11eab313a52e57f34bda", "operateResult": "成功" }, { "operateTime": 1574119935465, "operateSource": "MCU", "operator": "MCU", "operateCode": "关闭与会方麦克风", "operationObject": "a5db36ce0a5b11eab313a52e57f34bda", "operateResult": "成功" }, { "operateTime": 1574119944636, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "点名与会方", "operationObject": "a5db36ce0a5b11eab313a52e57f34bda", "operateResult": "成功" }, { "operateTime": 1574119944857, "operateSource": "MCU", "operator": "MCU", "operateCode": "停止声控", "operateResult": "成功" }, { "operateTime": 1574119945099, "operateSource": "MCU", "operator": "MCU", "operateCode": "打开与会方麦克风", "operationObject": "a5db36ce0a5b11eab313a52e57f34bda", "operateResult": "成功" }, { "operateTime": 1574119945861, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "广播与会方", "operationObject": "a5db36ce0a5b11eab313a52e57f34bda", "operateResult": "成功" }, { "operateTime": 1574119947619, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "挂断与会方", "operationObject": "a5db36ce0a5b11eab313a52e57f34bda", "operateResult": "成功" }, { "operateTime": 1574119947859, "operateSource": "MCU", "operator": "MCU", "operateCode": "取消广播与会方", "operateResult": "成功" }, { "operateTime": 1574119948460, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "删除与会方", "operationObject": "**********905", "operateResult": "成功" }, { "operateTime": 1574119949328, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "释放主持人", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" }, { "operateTime": 1574119950672, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "关闭与会方麦克风", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" }, { "operateTime": 1574119951805, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "取消全场静音", "operateResult": "成功" }, { "operateTime": 1574119952067, "operateSource": "MCU", "operator": "MCU", "operateCode": "打开与会方麦克风", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" }, { "operateTime": 1574119952954, "operateSource": "Portal", "operator": "Conference Operator", "operateCode": "申请发言", "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae", "operateResult": "成功" } ], "offset": 0, "limit": 20, "count": 23 }

响应参数 表4 响应参数 参数 类型 描述 offset Integer 查询偏移量。 limit Integer 每页的记录数。 count Integer 总记录数。 data Array of data objects 会控操作列表。 表5 data数据结构说明 参数 类型 描述 operateTime long 操作时间（UTC时间，单位毫秒）。 operateSource String 操作来源。 operator String 操作者。 operateCode String 操作描述。 operationObject String 被操作对象。 operateResult String 操作结果。 detail String 详情。

请求消息示例 GET /v1/mmc/management/conferences/history/confCtlRecord?confUUID=9a0fa6d10a5b11eaae5e191763c22c0e 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)

CURL命令示例 curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences/history/confCtlRecord?confUUID=9a0fa6d10a5b11eaae5e191763c22c0e'

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 confUUID 是 String Query 会议UUID。 offset 否 Integer Query 查询偏移量。默认为0。 limit 否 Integer Query 查询数量。默认值20，最大500条。 userUUID 否 String Query 用户的UUID。 说明： 该参数将废弃，请勿使用。 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Authorization-Type 否 String Header 标识是否为第三方portal过来的请求。 说明： 该参数将废弃，请勿使用。 X-Site-Id 否 String Header 用于区分到哪个H CS O站点鉴权。 说明： 该参数将废弃，请勿使用。 Accept-Language 否 String Header 语言 。默认简体中文。 zh-CN：简体中文。 en-US：美国英文。

CURL命令示例 curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Conference-Authorization:stb39b3f21898d4972fed86b3f22ac70914a77303def15e126a' -d '{"isLock": 1}' 'https://api.meeting.huaweicloud.com/v1/mmc/control/conferences/lock?conferenceID=914083136'

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 39 Connection: keep-alive http_proxy_id: 81e59ca1730e459417bf8b6c5376ecfa Server: api-gateway X-Request-Id: 2a40022a27536e9fbf3dba3dc7d4d443

请求消息示例 PUT /v1/mmc/control/conferences/lock?conferenceID=914083136 Connection: keep-alive X-Conference-Authorization:stbaf8fa2ea8a1b0e3ab2e007a85a75f88c55d5f6d5c1912dfb Content-Type: application/json Content-Length: 20 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "isLock":1 }

请求消息示例 GET​ /v1/metrics/conferences/history?startDate=1617206400000&endDate=1618588800000&offset=0&limit=20&searchKey=深圳分部 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: 2450 Connection: keep-alive Expires: 0 Pragma: No-cache Cache-Control: no-cache http_proxy_id: 6fba0eff9f832b463580fb06c5b0ff9c Server: api-gateway X-Request-Id: ac9f75ec3c97c823f128526a924532b2 { "count": 1, "limit": 10, "offset": 0, "data": [{ "confUUID": "a3d9a31c8af211eb8075a12479434adb", "conferenceID": "98909587", "subject": "研发晨会", "scheduserName": "深圳分部秘书", "deptName": "XXXXX", "alarm": "YES", "audioAlarm": "NO", "videoAlarm": "YES", "screenAlarm": "NO", "cpuAlarm": "NO", "timeZoneID": "56", "startTime": 1618220740926, "endTime": 1618222194202, "duration": 32, "participants": 52, "webinar": false }] }

CURL命令示例 curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d 'startDate=1617206400000&endDate=1618588800000' https://api.meeting.huaweicloud.com/v1/metrics/conferences/history

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 startDate 是 Long Query 查询的起始日期，Unix时间戳（单位毫秒）。 endDate 是 Long Query 查询的截止日期，Unix时间戳（单位毫秒）。 offset 否 Integer Query 查询偏移量。 取值：大于等于0，默认值为0 大于等于最大条目数量，则返回最后一页的数据 limit 否 Integer Query 查询的条目数量。 取值：1-500，默认值为20 searchKey 否 String Query 查询条件。会议主题、会议预约人和会议ID等可作为搜索内容。长度限制为1-512个字符。 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 39 Connection: keep-alive http_proxy_id: 6346df97898dcd1e9cb205b75f24fe65 Server: api-gateway X-Request-Id: 0294dd7aedd58db92a23de453cbcde0e

CURL命令示例 curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Conference-Authorization:stb39b3f21898d4972fed86b3f22ac70914a77303def15e126a' -d '{"manualSet": 0}' 'https://api.meeting.huaweicloud.com/v1/mmc/control/conferences/display/multiPicture?conferenceID=914083136'

请求消息示例 PUT /v1/mmc/control/conferences/display/multiPicture?conferenceID=914083136 Connection: keep-alive X-Conference-Authorization:stbaf8fa2ea8a1b0e3ab2e007a85a75f88c55d5f6d5c1912dfb Content-Type: application/json Content-Length: 27 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "manualSet": 0 }

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 conferenceID 是 String Query 会议ID。 X-Conference-Authorization 是 String Header 会控Token，通过获取会控token接口获得。 manualSet 是 Integer Body 是否为手工设置多画面。 0： 系统自动多画面 1： 手工设置多画面 imageType 否 String Body 多画面数目。手工设置多画面时有效。 Single：单画面 Two：二画面 Three：三画面 Four：四画面 Six：六画面 Nine：九画面 Sixteen：十六画面 subscriberInPics 否 Array of SubscriberInPic objects Body 子画面列表（手工设置多画面时必填）。 switchTime 否 Integer Body 表示轮询间隔,取值范围：10-120，默认10。单位：秒。 当同一个子画面中包含有多个与会者时，此参数有效。 表3 SubscriberInPic 数据结构 参数 是否必须 类型 描述 index 是 Integer 多画面中每个画面的编号。编号从1开始。 默认值为“1”。 subscriber 否 Array of strings 每个画面中与会者标识列表，从查询会议实时信息接口返回的pid中获取。 isAssistStream 否 Integer 是否为辅流。默认值为0。 0： 不是辅流 1： 是辅流

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 conferenceID 是 String Query 会议ID。 X-Conference-Authorization 是 String Header 会控Token，通过获取会控token接口获得。 viewType 是 Integer Body 主持人观看的画面类型。 0： 主持人轮询 1： 主持人观看多画面 2： 主持人选看会场 participantID 否 String Body 被主持人选看的会场。 当为主持人选看会场时为必填参数。 switchTime 否 Integer Body 轮询间隔，单位：秒。主持人轮询时，必填字段。 范围:[10-120]，默认值：10。 status 否 Integer Body 启动/停止轮询。主持人轮询时，必填字段。 0： 停止轮询 1： 启动轮询

请求消息示例 PUT /v1/mmc/control/conferences/chairView?conferenceID=914083136 Connection: keep-alive X-Conference-Authorization:stbaf8fa2ea8a1b0e3ab2e007a85a75f88c55d5f6d5c1912dfb content-type: application/json user-agent: WeLink-desktop Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "viewType":0 }

CURL命令示例 curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Conference-Authorization:stb39b3f21898d4972fed86b3f22ac70914a77303def15e126a' -d '{"viewType":0,"switchTime":"30","status":1}' https://api.meeting.huaweicloud.com/v1/mmc/control/conferences/chairView?conferenceID=914083136

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 39 Connection: keep-alive Expires: 0 Pragma: No-cache Cache-Control: no-cache http_proxy_id: 571b4dfceff545fae29aa14cea761079 Server: api-gateway X-Request-Id: f78b007ec2dabf1498620131c7bc19e0

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 1329 Connection: keep-alive Pragma: No-cache Cache-Control: no-cache Server: api-gateway X-Request-Id: b4facce44898efa03629afd189da7f5f { "count": 1, "data": [ { "filePath": "https://mock/download-file", "id": "835fe0052b2b4cc0ae1704fddad9e683", "lastUpdatedBy": "", "materialName": "test", "materialResolution": "", "materialSizeStr": "462.71KB", "updateTime": "1551755880176" } ], "limit": 5, "offset": 0 }

响应参数 表4 响应参数 参数 类型 描述 count Integer 总数量。 limit Integer 每页显示的条目数量。 默认值：10。 offset Integer 页面起始页，从0开始。 data Array of Material objects 素材信息。 表5 Material 数据结构 参数 类型 描述 filePath String 素材云盘存储文件下载地址。 id String 素材ID。 lastUpdatedBy String 更新者。 materialName String 素材名称。 materialResolution String 素材分辨率。 materialSizeStr String 素材大小(含单位)。 updateTime Long 更新时间。

请求消息示例 GET /v1/usg/sss/materials?offset=0&limit=5&searchKey= Connection: keep-alive X-Access-Token: cnrfzn5OLRjwoaOf2F7PfMwVjJ6zScFogbDE Content-Type: application/json Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 offset 否 Integer Query 查询偏移量，若超过最大数量，则返回最后一页。 默认值：0 limit 否 Integer Query 查询数量。 默认值：10 searchKey 否 String Query 搜索条件。支持素材名称、更新人模糊搜索。 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Request-Id 否 String Header 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。 Accept-Language 否 String Header 语言参数，默认为中文zh-CN，英文为en-US。