更新時間:2019-11-19
管理員或普通用戶可以通過該接口修改預(yù)約會議。會議開始時,不能修改會議。
請求方法 |
PUT |
---|---|
請求地址 |
/conferences/{conferenceid} |
傳輸協(xié)議 |
HTTPS |
參數(shù) |
是否必須 |
類型 |
位置 |
描述 |
---|---|---|---|---|
conferenceid |
是 |
String |
URL |
會議標識。 |
Authorization |
是 |
String |
Header |
授權(quán)令牌。將執(zhí)行鑒權(quán)響應(yīng)的accessToken 樣例:Basic Base64(accessToken) |
startTime |
否 |
String |
Body |
會議開始時間。使用UTC時間。修改預(yù)約會議時,如果沒有指定開始時間或填空串,則表示會議馬上開始。 格式:YYYY-MM-DD HH:MM |
length |
否 |
Int |
Body |
會議持續(xù)時長。單位分鐘,最長“1440”。 默認值為“30”。 |
subject |
否 |
String |
Body |
會議主題。長度限制為128個字符。 |
mediaTypes |
是 |
String |
Body |
會議的媒體類型。 由1個或多個枚舉String組成,多個枚舉時,每個枚舉值之間通過”,”逗號分隔。
|
attendees |
否 |
Attendee[0..*] |
Body |
預(yù)定會議時,指定的與會者列表。 該與會者列表可以用于發(fā)送會議通知、會議提醒、會議開始時候進行自動邀請。 |
conferenceType |
否 |
Int |
Body |
默認值為“0”。 注:周期會議為預(yù)留字段。 |
cycleParams |
有條件必選 |
Body |
周期會議的參數(shù)。當會議是周期會議的時候該參數(shù)必須填寫,否則服務(wù)器忽略該參數(shù)。 該參數(shù)包括周期會議的開始日期、結(jié)束日期、會議的周期和周期中的開會時間點。 (預(yù)留字段) |
|
isAutoRecord |
否 |
Int |
Body |
會議是否自動啟動錄制。該參數(shù)只有“recordType”為“1”“2”“3”的情況才生效。
默認值為“0”。 |
encryptMode |
否 |
Int |
Body |
會議媒體加密模式。
|
language |
否 |
String |
Body |
會議的默認語言。默認值由會議AS定義。 對于系統(tǒng)支持的語言,按照RFC3066規(guī)范傳遞,取值如下:
|
timeZoneID |
否 |
String |
Body |
開始時間的時區(qū)信息。 時區(qū)信息,參考時區(qū)映射關(guān)系。 |
recordType |
否 |
Int |
Body |
錄播類型。
|
liveChannelID |
否 |
String |
Body |
直播推流頻道ID,召開會議時,優(yōu)先根據(jù)此ID查詢頻道的URL,查詢不到則放棄推流;若不存在頻道ID則直接使用liveAddress/ auxAddress兩個URL。 |
liveAddress |
否 |
String |
Body |
主流直播地址。 |
auxAddress |
否 |
String |
Body |
輔流直播地址。 |
recordAuxStream |
否 |
Int |
Body |
是否錄制輔流。
|
confConfigInfo |
否 |
Body |
會議其他配置信息,用于其他會議配置參數(shù)。 后續(xù)新增的會議配置參數(shù)都在該結(jié)構(gòu)中定義。 |
|
vmrFlag |
否 |
Int |
Body |
是否使用VMR召開預(yù)約會議。
|
vmrID |
否 |
String |
Body |
用于識別用戶開會時綁定的VMR會議室。
|
參數(shù) |
類型 |
描述 |
---|---|---|
returnCode |
Int |
返回碼。 |
returnDesc |
String |
返回描述。 |
data |
ConferenceInfo[0..1] |
會議信息。 |
PUT /conferences/914038025 Connection: keep-alive Authorization: Basic VFZQdG9tOUcwN2NMWGhMQ1phaXpRUDFsNkdlUzVvT05Q 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) { "mediaTypes": "Voice,Video", "attendees": [ { "name": "user01", "role": 1, "phone": "+8657********" }], "conferenceType": 0, "subject": "user01的會議" }
HTTP/1.1 200 Date: Sat, 09 Mar 2019 07:12:49 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 1157 Connection: keep-alive http_proxy_id: 462abfcfa8a41c2c5450eb7648bf5ad2 Server: api-gateway X-Request-Id: 7ba6f742610c03a64262b126fb336a5d { "returnCode": 0, "returnDesc": "Success", "data": [ { "conferenceID": "914038025", "mediaTypes": "Voice,Data,Video", "subject": "user01的會議", "size": 1, "timeZoneID": "56", "startTime": "2019-03-10 08:04", "endTime": "2019-03-10 10:04", "conferenceState": "Schedule", "accessNumber": "+8657*******", "language": "zh-CN", "passwordEntry": [ { "conferenceRole": "chair", "password": "222400" }, { "conferenceRole": "general", "password": "896775" }], "userUUID": "ff8080816933ab4801694865840a00c2", "scheduserName": "user01", "multiStreamFlag": 1, "conferenceType": 0, "isAutoMute": 1, "isAutoRecord": 0, "chairJoinUri": "https://nmeeting.huaweicloud.com:38443/portal/j/914038025?p=26da22e56f444f8a3dc8746044d3bb8c2ded32a30b9325fd", "guestJoinUri": "https://nmeeting.huaweicloud.com:38443/portal/j/914038025?p=a21f8457701e3ee0a521b38f40591cebafc5450e94278930", "recordType": 0, "recordAuxStream": 0, "confConfigInfo": { "inviteMode": "AUTO_INVITE", "prolongLength": 15, "dispatchMode": "AUTO_DISPATCH", "isGuestFreePwd": false, "isSendNotify": true, "isSendSms": true, "isAutoMute": true }, "vmrFlag": 0, "scheduleVmr": false, "isHasRecordFile": false, "partAttendeeInfo": [ { "phone": "+8657*******", "name": "user01", "role": 1, "isMute": 0, "type": "normal" }], "terminlCount": 0, "normalCount": 0, "deptName": "huawei_ffl ", "confUUID": "19d6009f67fe11e9b78bbf16aed73b3c" }] }
curl -k -i -H 'content-type: application/json' -X PUT -H 'Authorization:Basic UHg4SmRpY3N3OERIRjN1UDE4Z0hHNlBGN2wzdDE3OWJv' -d '{"mediaTypes": "Voice","attendees": [{"name": "user02","role": 1,"phone": "+8657*******"}],"conferenceType": "0","subject": "user02 conference"}' 'https://api.meeting.huaweicloud.com/conferences/914007318'