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

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'