调用 DescribeLiveStreamUsageData 接口，查询指定时间流和协议维度的带宽、在线人数和请求数数据。

注意事项

• 请求频率：单用户请求频率限制为 30 次/秒。
• 数据延迟：数据延迟为 5 分钟。

请求说明

• 请求方式：POST
• 请求地址：https://live.volcengineapi.com?Action=DescribeLiveStreamUsageData&Version=2023-01-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Body

返回参数

下表仅列出本接口特有的返回参数。更多信息请见返回结构。

Response

DataInfoList

请求示例

GET https://live.volcengineapi.com?Action=DescribeLiveStreamUsageData&Version=2023-01-01
{
    "Domain": "example.com",
    "QueryTime": "2022-04-13 10:00"
}

返回示例

{
    "Status": 0,
    "Result": "",
    "Response": {
        "QueryTime": "2021-04-13 00:00",
        "DataInfoList": [
            {
                "StreamName": "stream001",
                "Domain": "example.com",
                "Bandwidth": 12,
                "Protocol": "Hls",
                "Request": 10,
                "OnlineUser": 20
            },
            {
                "StreamName": "stream001",
                "Domain": "example.com",
                "Bandwidth": 12,
                "Protocol": "Flv",
                "Request": 10,
                "OnlineUser": 20
            }
        ],
        "RequestId": "k54e3deb-f318-****-8a68-3c959642f9ec"
    }
}

错误码

下表仅列出本接口特有的错误码。更多信息请参见公共错误码获取详细信息。