查询直播流或域名的带宽监控数据

查询一定时间范围内的直播推/拉流或域名的带宽监控数据。支持查询删除域名的带宽数据。

注意事项

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

请求说明

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

请求参数

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

Query

Body

Region

返回参数

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

RegionResponse

BandwidthData

BandwidthDetailData

示例

请求示例

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

{
  "DomainList": [
    "example.com"
  ],
  "ProtocolList": [
    "HTTP-FLV",
    "RTMP"
  ],
  "ISPList": [
    "telecom"
  ],
  "IPList": [
    "123.123.123.000"
  ],
  "RegionList": [
    {
      "Area": "CN",
      "Country": "CN",
      "Province": "beijing"
    }
  ],
  "StartTime": "2021-04-13T00:00:00+08:00",
  "EndTime": "2021-04-14T00:00:00+08:00",
  "Aggregation": 300,
  "DetailField": [
    "Protocol"
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "201806041104200100100232280022D30",
    "Action": "DescribeLiveMetricBandwidthData",
    "Version": "2023-01-01",
    "Service": "live",
    "Region": "cn-north-1"
  },
  "Result": {
    "DomainList": [
      "example.com"
    ],
    "ProtocolList": [
      "HTTP-FLV",
      "RTMP"
    ],
    "ISPList": [
      "telecom"
    ],
    "IPList": [
      "123.123.123.000"
    ],
    "RegionList": [
      {
        "Area": "CN",
        "Country": "CN",
        "Province": "beijing"
      }
    ],
    "StartTime": "2021-04-13T00:00:00+08:00",
    "EndTime": "2021-04-14T00:00:00+08:00",
    "Aggregation": 300,
    "DetailField": [
      "Protocol"
    ],
    "PeakUpBandwidth": 20,
    "PeakDownBandwidth": 20,
    "BandwidthDataList": [
      {
        "TimeStamp": "2022-04-13T00:00:00+08:00",
        "UpBandwidth": 20,
        "DownBandwidth": 20
      },
      {
        "TimeStamp": "2022-04-13T00:05:00+08:00",
        "UpBandwidth": 20,
        "DownBandwidth": 20
      }
    ],
    "BandwidthDetailDataList": [
      {
        "Protocol": "HTTP-FLV",
        "PeakUpBandwidth": 20,
        "PeakDownBandwidth": 20,
        "BandwidthDataList": [
          {
            "TimeStamp": "2022-04-13T00:00:00+08:00",
            "UpBandwidth": 20,
            "DownBandwidth": 20
          },
          {
            "TimeStamp": "2022-04-13T00:05:00+08:00",
            "UpBandwidth": 20,
            "DownBandwidth": 20
          }
        ]
      },
      {
        "Protocol": "RTMP",
        "PeakUpBandwidth": 0,
        "PeakDownBandwidth": 0,
        "BandwidthDataList": [
          {
            "TimeStamp": "2022-04-13T00:00:00+08:00",
            "UpBandwidth": 0,
            "DownBandwidth": 0
          },
          {
            "TimeStamp": "2022-04-13T00:05:00+08:00",
            "UpBandwidth": 0,
            "DownBandwidth": 0
          }
        ]
      }
    ]
  }
}

错误码

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