华为云用户手册

请求消息示例 POST /v1/usg/dcs/corp/dept Connection: keep-alive X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki Content-Type: application/json Content-Length: 31 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "deptName": "test999" }

CURL命令示例 curl -k -i -H 'content-type: application/json' -X POST -H 'X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' -d '{"deptName": "test999"}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/dept

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 conference_id 是 String Path 网络研讨会ID。 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Request-Id 否 String Header 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。 Accept-Language 否 String Header 语言参数，默认为中文zh-CN，英文为en-US。

请求消息示例 GET /v1/wss/webinar/open/conferences/982311022 HTTP/1.1 Host: 251ba26eef46472d97fa4462d514b044.APIG.cn-north-7.huaweicloudapis.com User-Agent: APIGatewayDebugClient/1.0 X-Access-Token: cnr1519GbhwxP6eXPT70gHBabwCoAnFHezYAln4F X-APIG-Mode: debug

响应参数 表4 响应参数 参数 类型 描述 conferenceId String 网络研讨会ID。 corpId String 企业ID。 subject String 会议主题。长度限制为128个字符。 description String 网络研讨会主题。 startTime String 网络研讨会开始时间（UTC时间），格式“yyyy-MM-dd HH:mm”。 duration Integer 网络研讨会持续时长，单位分钟，取值范围[15,1440]。 timeZoneId Integer 会议通知中会议时间的时区信息。时区信息，参考时区映射关系。 说明： 举例：“timeZoneID”:"26"，则通过华为云会议发送的会议通知中的时间将会标记为如“2021/11/11 星期四 00:00 - 02:00 (GMT) 格林威治标准时间:都柏林, 爱丁堡, 里斯本, 伦敦”。 state String 会议状态。 schedule:预定状态 created:会议已经被创建并正在召开 destroyed:会议已经关闭 scheduserId String 网络研讨会预订者的用户UUID。 deptName String 预订者部门命名。 scheduserName String 预订者名称。 vmrPkgName String 网络研讨会VMR名称。 callRestriction Boolean 入会范围开关。 scope Integer 主持人、嘉宾入会范围。 0: 所有用户 2: 企业内用户 3: 被邀请用户 audienceScope Integer 观众入会范围。 0: 所有用户 2: 企业内用户和被邀请用户 chairJoinUri String 主持人入会地址。 chairPasswd String 主持人入会密码。 guestJoinUri String 嘉宾入会地址。 guestPasswd String 嘉宾入会密码。 audienceJoinUri String 观众入会地址。 audiencePasswd String 观众入会密码。 attendees Array of strings 与会嘉宾名称列表。 notifySetting NotifySetting object 网络研讨会通知配置。 enableRecording String 录制是否开启。 Y: 开启 N: 不开启 liveAddress String 主流直播推流地址。仅设置liveAddress，未设置auxAddress，无人共享时直播画面显示演讲者视图，有人共享时直播画面显示共享屏幕视图。若同时设置了liveAddress和auxAddress，liveAddress对应直播画面显示演讲者视图，auxAddress对应直播画面显示共享屏幕视图。 auxAddress String auxAddress对应辅流直播推流地址，在设置liveAddress后如果设置了auxAddress，liveAddress对应直播画面显示演讲者视图，auxAddress对应直播画面显示共享屏幕视图。 liveUrl String 直播观看地址。

响应消息示例 HTTP/1.1 200 OK Transfer-Encoding: chunked Cache-Control: no-cache Connection: keep-alive Content-Security-Policy: connect-src 'self' *.huaweicloud.com ;style-src 'self' 'unsafe-inline' 'unsafe-eval';object-src 'self'; font-src 'self' data:; Content-Type: application/json; charset=UTF-8 Date: Fri, 23 Apr 2021 07:44:58 GMT Pragma: no-cache Server: api-gateway Strict-Transport-Security: max-age=16070400; includeSubDomains X-APIG-Latency: 87 X-APIG-Ratelimit-Api: remain:99,limit:100,time:1 minute X-APIG-Ratelimit-Api-Allenv: remain:199,limit:200,time:1 second X-APIG-Upstream-Latency: 86 X-Content-Type-Options: nosniff X-Download-Options: noopen X-Envoy-Upstream-Service-Time: 32 X-Frame-Options: SAMEORIGIN X-Request-Id: 11379ed26a172206cf67e6288b0d73db X-Xss-Protection: 1;mode=block { "conferenceId": "982311022", "corpId": "314765464", "subject": "网络研讨会", "description": "", "startTime": "2021-04-29 11:00", "duration": 120, "timeZoneId": 56, "state": "schedule", "scheduserId": "bb05917f7363407ea6b1df019fdf257a", "scheduserName": "user", "vmrPkgName": "网络研讨会_1000方观众", "callRestriction": false, "scope": 0, "audienceScope": 0, "chairJoinUri": "https://meeting.huaweicloud.com/#/j/982311022/f78c393cad974a812828342da591f11cab00da91a2c43c3d", "chairPasswd": "116817", "guestJoinUri": "https://meeting.huaweicloud.com/#/j/982311022/8e057f959576587f9778a65a16a28a89be7a50793d10014d", "guestPasswd": "352218", "audienceJoinUri": "https://meeting.huaweicloud.com/#/j/982311022/aab78ec3fffcf54313802455d58449efa9617824aac4d7e5", "audiencePasswd": "441168", "notifySetting": { "enableCalendar": "N", "enableSms": "N", "enableEmail": "N" }, "attendees": ["user"], "enableRecording": "Y" }

请求消息示例 POST /v1/usg/sss/meeting-files/save-to-personal-space Connection: keep-alive X-Access-Token: cnrCAod6XrUexF5jUWmyxlyEcRStV8AsLwVI Content-Type: application/json Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "uuid": "42b8e80be5044513ae20edd4ad705272" }

响应消息示例 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: 270221481fc694f03628e85edf24a0b7

CURL命令示例 curl -k -i -H 'content-type: application/json' -X POST -H 'X-Access-Token: cnrCAod6XrUexF5jUWmyxlyEcRStV8AsLwVI' -d '{"uuid": "42b8e80be5044513ae20edd4ad705272"}' https://api.meeting.huaweicloud.com/v1/usg/sss/meeting-files/save-to-personal-space

响应消息示例 HTTP/1.1 200 Date: Tue, 17 Dec 2019 09:32:47 GMT Content-Type: application/json;charset=UTF-8 Connection: keep-alive Pragma: No-cache Cache-Control: no-cache Server: api-gateway X-Request-Id: 539e8b710378987ffc5eb844b5e5c290

请求消息示例 PUT /v1/usg/dcs/corp Connection: keep-alive X-Access-Token: stbdOWTjFFPAoDfJaWFGWnOTtepUlEsfhQSC Content-Type: application/json Content-Length: 27 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "address": "string" }

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Request-Id 否 String Header 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。 Accept-Language 否 String Header 语言参数，默认为中文zh-CN，英文为en-US。 address 否 String Body 企业所在地，最大长度为255个字符。 autoUserCreate 否 Boolean Body 企业自动开户开关。

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 offset 否 Integer Query 查询偏移量。 取值：大于等于0，默认值为0 若offset大于等于最大条目数量，则返回最后一页数据，页数根据总条目数和limit计算得出 limit 否 Integer Query 查询的条目数量。 取值：1-500，默认值为20 timeUnit 是 String Query 查询时间维度，取值： D: 按日查询 M: 按月查询 startTime 是 String Query 查询时间范围的开始时间，格式根据timeUnit的取值而定。 timeUnit = D，格式：yyyy-MM-dd，此情况下startTime与endTime间隔最多31日 timeUnit = M，格式：yyyy-MM，此情况下startTime与endTime间隔最多12个月 endTime 是 String Query 查询时间范围的结束时间，格式根据timeUnit的取值而定。 timeUnit = D，格式：yyyy-MM-dd，此情况下startTime与endTime间隔最多31日 timeUnit = M，格式：yyyy-MM，此情况下startTime与endTime间隔最多12个月 category 是 String Query 查询分类，取值： conference_info: 会议总体数据 conference_hourly_info: 单日内会议总体数据 category = conference_hourly_info时，timeUnit只能取值'D'，且startTime与endTime必须为同一天 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: 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": 2, "limit": 10, "offset": 0, "data": [{ "time": "2021-03-02", "confCount": "122", "confDuration": "1124", "attendeeCount": "261", "confConcurrentUsedCount": "11" }, { "time": "2021-03-03", "confCount": "122", "confDuration": "1124", "attendeeCount": "261", "confConcurrentUsedCount": "11" } ] }

CURL命令示例 curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -s "https://api.meeting.huaweicloud.com/v1/metrics/dashboard/statistic/conference/info?timeUnit=D&startTime=2021-03-02&endTime=2021-03-03&category=conference_info&offset=0&limit=20"

请求消息示例 GET /v1/metrics/dashboard/statistic/conference/info?timeUnit=D&startTime=2021-03-02&endTime=2021-03-03&category=conference_info&offset=0&limit=20 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)

请求示例 PUT https://{endpoint}/v1/mmc/control/conferences/setAttendeeLanChannel?conferenceID=968835906 { "listenLanChannel": "en", "speakLanChannel": "en", "participantIDs": ["13d2bf6895b211eea02cb5aed5470e35"] }

响应消息示例 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": 3, "limit": 10, "offset": 0, "data": [{ "time": "2021-03-18", "recordUsedSize": "0.23" }, { "time": "2021-03-19", "recordUsedSize": "4035.24" }, { "time": "2021-03-20", "recordUsedSize": "4036.24" } ] }

CURL命令示例 curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -s "https://api.meeting.huaweicloud.com/v1/metrics/dashboard/statistic/resource/info?timeUnit=D&startTime=2021-03-18&endTime=2021-03-20&category=used_record_info&offset=0&limit=10"

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 offset 否 Integer Query 查询偏移量。 取值：大于等于0，默认值为0 若offset大于等于最大条目数量，则返回最后一页数据，页数根据总条目数和limit计算得出 limit 否 Integer Query 查询的条目数量。 取值：1-500，默认值为20 timeUnit 是 String Query 查询时间维度，取值： D: 按日查询 M: 按月查询 startTime 是 String Query 查询时间范围的开始时间，格式根据timeUnit的取值而定。 timeUnit = D，格式：yyyy-MM-dd，此情况下startTime与endTime间隔最多31日 timeUnit = M，格式：yyyy-MM，此情况下startTime与endTime间隔最多12个月 endTime 是 String Query 查询时间范围的结束时间，格式根据timeUnit的取值而定。 timeUnit = D，格式：yyyy-MM-dd，此情况下startTime与endTime间隔最多31日 timeUnit = M，格式：yyyy-MM，此情况下startTime与endTime间隔最多12个月 category 是 String Query 查询分类，取值： used_vmr_info: 已购VMR资源使用统计数据 used_live_info: 已购直播端口资源使用统计数据 used_record_info: 已购录播资源使用统计数据 used_pstn_info: 已购电话外呼资源使用统计数据 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。

响应参数 表4 响应参数 参数 类型 描述 count Integer 总记录数。 limit Integer 查询条目数量。 offset Integer 查询偏移量。 data Array of StatisticResourceDataItem objects 会议已购资源使用数据按时间点统计的查询结果数组。 表5 StatisticResourceDataItem数据结构 参数名称 参数类型 描述 time String 日期/月份。 vmrParties String VMR方数。 category = used_vmr_info时有效。 maxConcurrencyVmrCount String VMR并发使用数。 category = used_vmr_info时有效。 livePortUsedCount String 直播端口并发使用数。 category = used_live_info时有效。 recordUsedSize String 录播使用空间(G)。 category = used_record_info时有效。 pstnUsedDuration String PSTN外呼时长(分钟)。 category = used_pstn_info时有效。

请求消息示例 GET /v1/metrics/dashboard/statistic/resource/info?timeUnit=D&startTime=2021-03-18&endTime=2021-03-20&category=used_record_info&offset=0&limit=10 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)

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 corp_id 是 String Path 企业id。 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Request-Id 否 String Header 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。 Accept-Language 否 String Header 语言参数，默认为中文zh-CN，英文为en-US。 [数组元素] 是 Array of ResourceDTO objects Body 待添加的资源列表，最多支持批量处理100个。

请求消息示例 POST /v1/usg/dcs/sp/corp/818803911/resource Connection: keep-alive X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki Content-Type: application/json Content-Length: 31 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) [ { "count": 10, "expireDate": 2549030400000, "type": "VMR", "typeId": "ff808081699b56cb0169c411a0980152" } ]

CURL命令示例 curl -k -i -H 'content-type: application/json' -X POST -H 'X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' -d '[{"count": 10,"expireDate": 2549030400000,"id": "733ff391f2a14360af3b93bd1325f9f9","type": "VMR","typeId": "ff808081699b56cb0169c411a0980152"}]' https://api.meeting.huaweicloud.com/v1/usg/dcs/sp/corp/818803911/resource

请求消息示例 PUT /v1/usg/dcs/corp/device/status/0 Connection: keep-alive X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF Content-Type: application/json Content-Length: 47 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) ["asdasfscasd"]

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

CURL命令示例 curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' -d '["asdasfscasd"]' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/device/status/0

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 value 是 Integer Path 状态。 0：启用 1：停用 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Request-Id 否 String Header 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。 Accept-Language 否 String Header 语言参数，默认为中文zh-CN，英文为en-US。 [数组元素] 是 Array of strings Body 终端序列号列表，当SN对应的终端状态一致的，则忽略该记录。 maxLength：100 minLength：1

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 308 Connection: keep-alive Pragma: No-cache Cache-Control: no-cache Server: api-gateway X-Request-Id: fbbc91569f0efed914e0427fc2a9c4ac { "count" : 1, "data" : [ { "device" : { "id" : "22c1804004374b558084c50e44e77085", "mark" : "13456789" }, "id" : "ff8080816c52e2a6016c53878f030030", "member" : { "id" : "nhl", "mark" : "nhl(nhl)" }, "status" : 0, "vmrId" : "9*******7", "vmrName" : "云会议室", "vmrPkgName" : "小型云会议室-10方", "vmrPkgParties" : 10, "maxAudienceParties": 1000, "commercialMaxAudienceParties": 1000, "expireDate": 1666195200000 } ], "limit" : 10, "offset" : 0 }