查詢直播域名實(shí)時(shí)流量監(jiān)控?cái)?shù)據(jù)
調(diào)用DescribeLiveDomainRealTimeTrafficData查詢直播域名的實(shí)時(shí)流量監(jiān)控?cái)?shù)據(jù)。
使用說明
- 調(diào)用本接口查詢播流域名下某個(gè)區(qū)域、運(yùn)營(yíng)商、時(shí)間段內(nèi)的實(shí)時(shí)帶寬流量。
- 不指定StartTime和EndTime時(shí),默認(rèn)讀取過去1小時(shí)的數(shù)據(jù),同時(shí)支持按指定的起止時(shí)間查詢,兩者需要同時(shí)指定。
- 本接口為監(jiān)控?cái)?shù)據(jù)接口,數(shù)據(jù)采集處理方式不同于計(jì)費(fèi),不能用于計(jì)算用量進(jìn)行對(duì)賬參考。
- 最多可獲取最近90天的數(shù)據(jù)。
QPS限制
本接口無單用戶QPS限制,請(qǐng)您根據(jù)實(shí)際需要合理調(diào)用。更多信息,請(qǐng)參見QPS限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveDomainRealTimeTrafficData | 系統(tǒng)規(guī)定參數(shù)。取值:DescribeLiveDomainRealTimeTrafficData。 |
DomainName | String | 是 | example.com,example.aliyundoc.com | 播流域名。 多個(gè)域名之間用英文逗號(hào)(,)分隔。 |
StartTime | String | 否 | 2015-12-10T15:00:00Z | 起始時(shí)間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 說明 不寫默認(rèn)讀取過去1小時(shí)數(shù)據(jù)。 |
IspNameEn | String | 否 | alibaba | 運(yùn)營(yíng)商英文名。 通過DescribeCdnRegionAndIsp接口獲得。 |
LocationNameEn | String | 否 | tianjin | 區(qū)域英文名。 通過DescribeCdnRegionAndIsp接口獲得。 |
EndTime | String | 否 | 2015-12-10T15:01:00Z | 結(jié)束時(shí)間。需晚于起始時(shí)間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
返回?cái)?shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
EndTime | String | 2015-12-10T15:01:00Z | 結(jié)束時(shí)間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
StartTime | String | 2015-12-10T15:00:00Z | 起始時(shí)間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
RequestId | String | A666D44F-19D6-490E-97CF-1A64AB962C57 | 請(qǐng)求ID。 |
DomainName | String | example.com,example.aliyundoc.com | 播流域名。 |
DataInterval | String | 60 | 每條記錄的時(shí)間間隔。單位:秒。 |
RealTimeTrafficDataPerInterval | Array of DataModule | 每個(gè)時(shí)間間隔的流量數(shù)據(jù)。 |
|
DataModule | |||
Value | String | 0 | 流量數(shù)據(jù)。單位:字節(jié)。 |
TimeStamp | String | 2015-12-10T15:01:00Z | 時(shí)間片起始時(shí)刻。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時(shí)間)。 |
示例
請(qǐng)求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainRealTimeTrafficData
&DomainName=example.com,example.aliyundoc.com
&<公共請(qǐng)求參數(shù)>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLiveDomainRealTimeTrafficDataResponse>
<EndTime>2015-12-10T15:01:00Z</EndTime>
<StartTime>2015-12-10T15:00:00Z</StartTime>
<RequestId>A666D44F-19D6-490E-97CF-1A64AB962C57</RequestId>
<DomainName>example.com,example.aliyundoc.com</DomainName>
<DataInterval>60</DataInterval>
<RealTimeTrafficDataPerInterval>
<Value>0</Value>
<TimeStamp>2015-12-10T15:01:00Z</TimeStamp>
</RealTimeTrafficDataPerInterval>
</DescribeLiveDomainRealTimeTrafficDataResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"EndTime" : "2015-12-10T15:01:00Z",
"StartTime" : "2015-12-10T15:00:00Z",
"RequestId" : "A666D44F-19D6-490E-97CF-1A64AB962C57",
"DomainName" : "example.com,example.aliyundoc.com",
"DataInterval" : "60",
"RealTimeTrafficDataPerInterval" : [ {
"Value" : "0",
"TimeStamp" : "2015-12-10T15:01:00Z"
} ]
}
錯(cuò)誤碼
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime參數(shù)錯(cuò)誤,請(qǐng)您確認(rèn)該StartTime參數(shù)是否正確。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結(jié)束時(shí)間錯(cuò)誤,請(qǐng)您確認(rèn)結(jié)束時(shí)間是否正確。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 結(jié)束時(shí)間與開始時(shí)間不匹配,請(qǐng)您確認(rèn)時(shí)間的匹配度。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 傳入的StartTime參數(shù)不支持。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。