查询拉流转推带宽用量

查询一定时间范围内，直播拉流转推至第三方的带宽用量。

注意事项

• 请求频率：单用户请求频率限制为 100 次/秒。
• 数据延迟：数据延迟为 15 分钟。
• 数据进制：带宽数据统计进制为 1000，例如，1 Mbps = 1000 Kbps。

请求说明

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

请求参数

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

Query

Body

返回参数

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

BandwidthDataList

BandwidthDetailDataList

示例

请求示例

POST https://live.volcengineapi.com?Action=DescribeLivePullToPushBandwidthData&Version=2023-01-01

{
    "DomainList": [
        "example.com"
    ],
    "DstAddrTypeList": [
        "live",
        "Third"
    ],
    "StartTime": "2021-04-13T00:00:00+08:00",
    "EndTime": "2021-04-14T00:00:00+08:00",
    "Aggregation": 300,
    "DetailField": [
        "Domain"
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "201806041104200100100232280022D30",
        "Action": "DescribeLivePullToPushBandwidthData",
        "Version": "2023-01-01",
        "Service": "live",
        "Region": "cn-north-1"
    },
    "Result": {
        "DomainList": [
            "example.com"
        ],
        "DstAddrTypeList": [
            "Live",
            "Third"
        ],
        "StartTime": "2021-04-13T00:00:00+08:00",
        "EndTime": "2021-04-14T00:00:00+08:00",
        "Aggregation": 300,
        "DetailField": [
            "Domain"
        ],
        "PeakUpBandwidth": 12,
        "BandwidthDataList": [
            {
                "TimeStamp": "2022-04-13T00:00:00+08:00",
                "UpBandwidth": 12
            },
            {
                "TimeStamp": "2022-04-13T00:00:05+08:00",
                "UpBandwidth": 10
            }
        ],
        "BandwidthDetailDataList": [
            {
                "DstAddrType": "Live",
                "PeakUpBandwidth": 12,
                "BandwidthDataList": [
                    {
                        "TimeStamp": "2022-04-13T00:00:00+08:00",
                        "UpBandwidth": 12
                    },
                    {
                        "TimeStamp": "2022-04-13T00:00:05+08:00",
                        "UpBandwidth": 10
                    }
                ]
            },
            {
                "DstAddrType": "Third",
                "PeakUpBandwidth": 12,
                "BandwidthDataList": [
                    {
                        "TimeStamp": "2022-04-13T00:00:00+08:00",
                        "UpBandwidth": 12
                    },
                    {
                        "TimeStamp": "2022-04-13T00:00:05+08:00",
                        "UpBandwidth": 10
                    }
                ]
            }
        ]
    }
}

错误码

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