调用 DescribeLiveEdgeStatData 接口，查询指定协议、运营商、区域、时间范围下，直播流产生的上下行流量、上下行峰值带宽和请求数等数据。

注意事项

• 使用限制：
  • 边缘数据中的流量数据用于数据监控，其采集方式不同于流量用量数据，请使用 DescribeLiveTrafficData 查询直播流量用量数据。
  • 边缘数据中的带宽数据用于数据监控，其采集方式不同于带宽用量数据，请使用 DescribeLiveBandwidthData 查询直播带宽用量数据。
• 请求频率：单用户请求频率限制为 30 次/秒。
• 数据延迟：时间粒度为 60 秒时，数据延迟为 5 分钟；其他时间粒度时，数据延迟为 15 分钟。
• 数据进制：
  • 流量数据统计进制为 1000，例如，1 GB = 1000 MB。
  • 带宽数据统计进制为 1000，例如，1 Mbps = 1000 Kbps。

请求说明

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

调试

请求参数

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

Query

Body

Region

返回参数

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

Region

EdgeStatDataList

EdgeStatDetailDataList

请求示例

POST https://live.volcengineapi.com?Action=DescribeLiveEdgeStatData&Version=2023-01-01
{
    "DomainList": [
        "push.example.com",
        "pull.example.com"
    ],
    "ProtocolList": [
        "HTTP-FLV",
        "RTMP"
    ],
    "ISPList": [
        "unicom",
        "telecom"
    ],
    "RegionList": [
        {
            "Area": "CN",
            "Country": "CN",
            "Province": "beijing"
        }
    ],
    "StartTime": "2024-12-12T00:00:00+08:00",
    "EndTime": "2024-12-12T01:00:00+08:00",
    "Aggregation": 300,
    "DetailField": [
        "Domain"
    ],
    "AppList": [
        "live"
    ],
    "StreamList": [
        "stream001",
        "stream002"
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "DescribeLiveEdgeStatData",
        "Version": "2023-01-01",
        "Service": "live",
        "Region": "cn-north-1"
    },
    "Result": {
        "DomainList": [
            "push.example.com",
            "pull.example.com"
        ],
        "ProtocolList": [
            "HTTP-FLV",
            "RTMP"
        ],
        "ISPList": [
            ""
        ],
        "RegionList": [
            {
                "Area": "CN",
                "Country": "CN",
                "Province": "beijing"
            }
        ]
        ],
        "StartTime": "2024-12-12T00:00:00+08:00",
        "EndTime": "2024-12-12T01:00:00+08:00",
        "Aggregation": 300,
        "DetailField": [
            ""
        ],
        "TotalUpTraffic": 20,
        "TotalDownTraffic": 20,
        "AppList": [
            "live",
            "livevod"
        ],
        "StreamList": [
            "stream001",
            "stream002"
        ],
        "PeakUpBandwidth": 10,
        "PeakDownBandwidth": 10,
        "TotalRequest": 5,
        "EdgeStatDataList": [
            {
                "TimeStamp": "2024-12-12T00:00:00+08:00",
                "UpTraffic": 20,
                "DownTraffic": 20,
                "UpBandwidth": 10,
                "DownBandwidth": 10,
                "Request": 5
            }
        ],
        "EdgeStatDetailDataList": [
            {
                "Protocol": "HTTP-FLV",
                "Domain": "push。example.com",
                "ISP": "telecom",
                "TotalUpTraffic": 20,
                "TotalDownTraffic": 20,
                "PeakUpBandwidth": 10,
                "PeakDownBandwidth": 10,
                "TotalRequest": 5,
                "EdgeStatDataList": [
                    {
                        "TimeStamp": "2024-12-12T00:00:00+08:00",
                        "UpTraffic": 20,
                        "DownTraffic": 20,
                        "UpBandwidth": 10,
                        "DownBandwidth": 10,
                        "Request": 5
                    }
                ]
            }
        ]
    }
}

错误码

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