查询直播域名实时带宽数据 - 视频直播

使用说明

调用本接口查询指定域名的流量和带宽使用情况。
可以查询最近7天内的数据，单次查询StartTime和EndTime跨度不能超过24小时。
如果StartTime和EndTime均未指定，默认返回当前时间起1小时内的数据。
本接口为监控数据接口，数据采集处理方式不同于计费，不能用于计算用量进行对账参考。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveDomainRealTimeBpsData	系统规定参数。取值：DescribeLiveDomainRealTimeBpsData。
DomainName	String	是	example.com,example.aliyundoc.com	播流域名。多个域名之间用英文逗号（,）分隔。
IspNameEn	String	否	alibaba	运营商英文名。通过DescribeCdnRegionAndIsp接口获得。
LocationNameEn	String	否	tianjin	区域英文名。通过DescribeCdnRegionAndIsp接口获得。
StartTime	String	否	2015-11-30T05:39:00Z	起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
EndTime	String	否	2015-11-30T05:40:00Z	结束时间。需晚于起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。说明不填默认查询从StartTime起一小时内的数据。

返回数据

名称	类型	示例值	描述
EndTime	String	2015-11-30T05:40:00Z	结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
StartTime	String	2015-11-30T05:33:00Z	起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
RequestId	String	BC858082-736F-4A25-867B-E5B67C85ACF7	请求ID。
DomainName	String	example.com,example.aliyundoc.com	播流域名信息。
DataInterval	String	60	查询数据的时间粒度。
RealTimeBpsDataPerInterval	Array of DataModule		域名1分钟粒度带宽数据。
DataModule
Value	String	59392614.8	带宽数据，单位：bit/second。
TimeStamp	String	2015-11-30T05:39:00Z	数据时间戳。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainRealTimeBpsData
&DomainName=example.com,example.aliyundoc.com
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeLiveDomainRealTimeBpsDataResponse>
<EndTime>2015-11-30T05:40:00Z</EndTime>
<RequestId>BC858082-736F-4A25-867B-E5B67C85ACF7</RequestId>
<DomainName>example.com,example.aliyundoc.com</DomainName>
<DataInterval>60</DataInterval>
<StartTime>2015-11-30T05:33:00Z</StartTime>
<RealTimeBpsDataPerInterval>
    <DataModule>
        <Value>59392614.8</Value>
        <TimeStamp>2015-11-30T05:39:00Z</TimeStamp>
    </DataModule>
</RealTimeBpsDataPerInterval>
</DescribeLiveDomainRealTimeBpsDataResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DescribeLiveDomainRealTimeBpsDataResponse" : {
    "EndTime" : "2015-11-30T05:40:00Z",
    "RequestId" : "BC858082-736F-4A25-867B-E5B67C85ACF7",
    "DomainName" : "example.com,example.aliyundoc.com",
    "DataInterval" : 60,
    "StartTime" : "2015-11-30T05:33:00Z",
    "RealTimeBpsDataPerInterval" : {
      "DataModule" : {
        "Value" : 5.93926148E7,
        "TimeStamp" : "2015-11-30T05:39:00Z"
      }
    }
  }
}

错误码

访问错误中心查看更多错误码。