更新时间:2023-12-29 GMT+08:00

编辑周期性会议的子会议

描述

该接口用于修改已预约的周期性会议的子会议。会议开始后,不能被修改。

调试

您可以在API Explorer中调试该接口。

接口原型

表1 接口原型

请求方法

PUT

请求地址

/v1/mmc/management/conferences/cyclesubconf

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

conferenceID

String

Query

会议ID。

userUUID

String

Query

用户的UUID。

说明:

该参数将废弃,请勿使用。

X-Access-Token

String

Header

授权令牌。获取“执行App ID鉴权”响应的accessToken。

X-Authorization-Type

String

Header

标识是否为第三方portal过来的请求。

说明:

该参数将废弃,请勿使用。

X-Site-Id

String

Header

用于区分到哪个HCSO站点鉴权。

说明:

该参数将废弃,请勿使用。

cycleSubConfID

string

Body

子会议UUID。

mediaTypes

string

Body

会议的媒体类型。

  • Voice:语音会议
  • HDVideo:视频会议

startTime

string

Body

会议开始时间(UTC时间)。格式:yyyy-MM-dd HH:mm。

说明:
  • 如果没有指定开始时间或填空串,则表示会议马上开始
  • 时间是UTC时间,即0时区的时间

length

Integer

Body

会议持续时长,单位分钟。默认30分钟。

最大1440分钟(24小时),最小15分钟。

isAutoRecord

Integer

Body

会议是否自动启动录制,在录播类型为:录播、录播+直播时才生效。默认为不自动启动。

  • 1:自动启动录制
  • 0:不自动启动录制

confConfigInfo

ConfConfigInfo object

Body

会议其他配置信息。

recordAuthType

Integer

Body

录播观看鉴权方式,在录播类型为:录播、直播+录播时有效。

  • 0:可通过链接观看/下载
  • 1:企业用户可观看/下载
  • 2:与会者可观看/下载

description

string

Body

会议描述,长度限制为200个字符。

表3 ConfConfigInfo 数据结构

参数

是否必须

类型

位置

描述

callInRestriction

Integer

Body

允许加入会议的范围。

  • 0: 所有用户
  • 2: 企业内用户
  • 3: 被邀请用户

audienceCallInRestriction

Integer

Body

允许加入网络研讨会的观众范围。

  • 0:所有用户
  • 2:企业内用户和被邀请用户

allowGuestStartConf

Boolean

Body

是否允许来宾启动会议。

  • true: 允许来宾启动会议
  • false: 禁止来宾启动会议
说明:

仅随机会议ID有效。

enableWaitingRoom

Boolean

Body

是否启用等候室。

showAudienceCountInfo

ShowAudienceCountInfo object

Body

网络研讨会观众数显示策略。

表4 ShowAudienceCountInfo 数据结构

参数

是否必须

类型

位置

描述

showAudienceMode

Integer

Body

观众显示策略:服务端用来计算观众人数下发给客户端控制观众显示。

  • 0: 不显示
  • 1: 倍增显示与会人数。基于实时与会人数或累计与会人次(假设为N),可以再进行倍增设置。支持设置倍增倍数X和基础人数Y,设置后,显示的人数为:N*X+Y

baseAudienceCount

Integer

Body

基础人数。范围是0~10000。

multiple

Double

Body

倍增倍数。范围是1~10, 支持设置到小数点后1位。

状态码

表5 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常。

响应参数

请求消息示例

PUT /v1/mmc/management/conferences/cyclesubconf?conferenceID=985325849
Connection: keep-alive
X-Access-Token: cnr1510zTBhrfUsymQ0srhW2RYS99r9G5SQoTLWN
Content-Type: application/json
user-agent: WeLink-desktop
Content-Length: 372
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "cycleSubConfID": "393439b00a2e11ecbe71d7c576a87729",
    "mediaTypes": "Video",
    "startTime": "2021-09-01 07:36",
    "length": 45,
    "description": ""
}

响应消息示例

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 2164
Connection: keep-alive
http_proxy_id: 462abfcfa8a41c2c5450eb7648bf5ad2
Server: api-gateway
X-Request-Id: 7ba6f742610c03a64262b126fb336a5d

错误码

当您使用华为云会议服务端API时,如果遇到“MMC”或者“USG”开头的错误码,请参考华为云API错误中心

CURL命令示例

curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token:cnr1510zTBhrfUsymQ0srhW2RYS99r9G5SQoTLWN' -d '{"cycleSubConfID": "393439b00a2e11ecbe71d7c576a87729","mediaTypes": "Video","startTime": "2021-09-01 07:36","length": 45,"description": ""}' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences/cyclesubconf?conferenceID=985325849'