调用DescribeLiveDomainRealTimeBpsData获取域名1分钟粒度带宽数据。

说明 可以查询7天内的数据,单次查询StartTime和EndTime跨度不能超过24小时; 如果StartTime和EndTime均未指定,默认返回当前时间起一小时内的数据;调用频率限制10次/秒

调试

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

请求参数

名称 位置 类型 是否必选 示例值 描述
Action Query String DescribeLiveDomainRealTimeBpsData

系统规定参数,取值:DescribeLiveDomainRealTimeBpsData

DomainName Query String test.com,abc.com

域名。

RegionId Host String cn-shanghai

区域。

IspNameEn Query String alibaba

运营商英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有运营商。

LocationNameEn Query String tianjin

区域英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有区域。

StartTime Query String 2015-11-30T05:39:00Z

起始时间。

日期格式按照ISO8601表示法,并使用UTC时间。 例如:2016-10-20T04:00:00Z

EndTime Query String 2015-11-30T05:40:00Z

结束时间。

  • 日期格式按照ISO8601表示法,并使用UTC时间。 例如:2016-10-20T04:00:00Z
  • 不填默认查询从StartTime起一小时内的数据。

返回数据

名称 类型 示例值 描述
DataInterval String 60

查询数据的时间粒度。

DomainName String test.com,abc.com

直播域名信息。

EndTime String 2015-11-30T05:40:00Z

结束时间。

RealTimeBpsDataPerInterval Array of DataModule

域名1分钟粒度带宽数据。

DataModule
TimeStamp String 2015-11-30T05:39:00Z

数据时间戳。

Value String 59392614.8

带宽数据,单位是bit/second

RequestId String BC858082-736F-4A25-867B-E5B67C85ACF7

请求ID。

StartTime String 2015-11-30T05:33:00Z

开始时间。

示例

请求示例

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

正常返回示例

XML 格式

<DescribeLiveDomainRealTimeBpsDataResponse>
	  <RealTimeBpsDataPerInterval>
		    <DataModule>
			      <TimeStamp>2018-01-02T11:05:00Z</TimeStamp>
			      <Value>16710625.733333332</Value>
		    </DataModule>
		    <DataModule>
			      <TimeStamp>2018-01-02T11:04:00Z</TimeStamp>
			      <Value>59392614.8</Value>
		    </DataModule>
	  </RealTimeBpsDataPerInterval>
	  <RequestId>B49E6DDA-F413-422B-B58E-2FA23F286726</RequestId>
	  <DomainName>test.com</DomainName>
	  <EndTime>2017-12-10T21:00:00Z</EndTime>
	  <DataInterval>300</DataInterval>
	  <StartTime>2017-12-10T20:00:00Z</StartTime>
</DescribeLiveDomainRealTimeBpsDataResponse>

JSON 格式

{
   "RealTimeBpsDataPerInterval":{
      "DataModule":[
         {
            "TimeStamp":"2018-01-02T11:05:00Z",
            "Value":16710625.733333332
         },
         {
            "TimeStamp":"2018-01-02T11:04:00Z",
            "Value":59392614.8
         }
      ]
   },
   "RequestId":"B49E6DDA-F413-422B-B58E-2FA23F286726",
   "DomainName":"test.com",
   "EndTime":"2017-12-10T21:00:00Z",
   "DataInterval":"300",
   "StartTime":"2017-12-10T20:00:00Z"
}

错误码

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