Help Center/ Meeting/ Server API Reference/ Meeting Management/ APIs/ Querying Meeting Control Records of a Historical Meeting

Updated on 2023-12-22 GMT+08:00

Online Debugging

CLI Examples

View PDF

Querying Meeting Control Records of a Historical Meeting

Description

This API is used to query meeting control records of a historical meeting.

Debugging

You can debug this API in API Explorer.

Prototype

**Table 1** Prototype
Request Method	GET
Request Address	/v1/mmc/management/conferences/history/confCtlRecord
Transport Protocol	HTTPS

Request Parameters

**Table 2** Parameters
Parameter	Mandatory	Type	Location	Description
confUUID	Yes	String	Query	Meeting UUID.
offset	No	Integer	Query	Query offset. Default value: 0.
limit	No	Integer	Query	Number of records to query. The default value is 20 and the maximum value is 500.
userUUID	No	String	Query	UUID of a user. NOTE: This parameter will be discarded. Do not use it.
X-Access-Token	Yes	String	Header	Authorization token. Use the value of accessToken in the response to the request for Authenticating an App ID.
X-Authorization-Type	No	String	Header	Whether the request is sent from a third-party portal. NOTE: This parameter will be discarded. Do not use it.
X-Site-Id	No	String	Header	ID of the HCS Online site where the authentication is performed. NOTE: This parameter will be discarded. Do not use it.
Accept-Language	No	String	Header	Language. Default value: zh-CN. zh-CN: simplified Chinese. en-US: English (U.S.).

Status Codes

**Table 3** Status codes
HTTP Status Code	Description
200	Operation successful.
400	Invalid parameters.
401	Authentication is not performed or fails.
403	Insufficient permissions.
500	Server exception.

Response Parameters

**Table 4** Response parameters
Parameter	Type	Description
offset	Integer	Query offset.
limit	Integer	Number of records on each page.
count	Integer	Total number of records.
data	Array of data objects	List of meeting control operations.

**Table 5** Data structure of data
Parameter	Type	Description
operateTime	long	UTC time when an operation was performed, in milliseconds.
operateSource	String	Operation source.
operator	String	Operator.
operateCode	String	Operation description.
operationObject	String	Operation object.
operateResult	String	Operation result.
detail	String	Operation details.

Example Request

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)

Example Response

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": "Enable voice activation.",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119917864,
            "operateSource": "Conference System",
            "operator": "Conference System",
            "operateCode": "Call participants.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119917870,
            "operateSource": "MCU",
            "operator": "MCU",
            "operateCode": "Mute participants.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119918064,
            "operateSource": "MCU",
            "operator": "MCU",
            "operateCode": "Unmute participants.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119917889,
            "operateSource": "Conference System",
            "operator": "Conference System",
            "operateCode": "Set a participant as the host.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119932913,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Add participants.",
            "operationObject": "**********905",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119935460,
            "operateSource": "Conference System",
            "operator": "Conference System",
            "operateCode": "Call participants.",
            "operationObject": "a5db36ce0a5b11eab313a52e57f34bda",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119935465,
            "operateSource": "MCU",
            "operator": "MCU",
            "operateCode": "Mute participants.",
            "operationObject": "a5db36ce0a5b11eab313a52e57f34bda",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119944636,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Give floor to participants.",
            "operationObject": "a5db36ce0a5b11eab313a52e57f34bda",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119944857,
            "operateSource": "MCU",
            "operator": "MCU",
            "operateCode": "Disable voice activation.",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119945099,
            "operateSource": "MCU",
            "operator": "MCU",
            "operateCode": "Unmute participants.",
            "operationObject": "a5db36ce0a5b11eab313a52e57f34bda",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119945861,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Broadcast participants.",
            "operationObject": "a5db36ce0a5b11eab313a52e57f34bda",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119947619,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Disconnect participants.",
            "operationObject": "a5db36ce0a5b11eab313a52e57f34bda",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119947859,
            "operateSource": "MCU",
            "operator": "MCU",
            "operateCode": "Cancel broadcasting participants.",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119948460,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Remove participants.",
            "operationObject": "**********905",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119949328,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Relinquish the host role.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119950672,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Mute participants.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119951805,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Unmute all participants.",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119952067,
            "operateSource": "MCU",
            "operator": "MCU",
            "operateCode": "Unmute participants.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        },
        {
            "operateTime": 1574119952954,
            "operateSource": "Portal",
            "operator": "Conference Operator",
            "operateCode": "Request the floor.",
            "operationObject": "9bd1c8b20a5b11eab31381603f51d3ae",
            "operateResult": "Successful"
        }
    ],
    "offset": 0,
    "limit": 20,
    "count": 23
}

Error Codes

If an error code starting with MMC or USG is returned when you use this API, rectify the fault by following the instructions provided in Huawei Cloud API Error Center.

Example cURL Command

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

Parent topic: APIs

Previous topic: Viewing Historical Meeting Details

Next topic: Querying Participant Records of a Historical Meeting