調用DescribeLiveDomainTrafficData查詢直播域名網(wǎng)絡流量監(jiān)控數(shù)據(jù)。
使用說明
- 不指定StartTime和EndTime時,默認讀取過去24小時的數(shù)據(jù)。
- 本接口為監(jiān)控數(shù)據(jù)接口,數(shù)據(jù)采集處理方式不同于計費,不能用于計算用量進行對賬參考。
QPS限制
本接口的單用戶QPS限制為100次/秒。超過限制,API調用會被限流,這可能會影響您的業(yè)務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveDomainTrafficData | 系統(tǒng)規(guī)定參數(shù)。取值:DescribeLiveDomainTrafficData。 |
DomainName | String | 否 | example.com | 播流域名。多個域名之間用英文逗號(,)分隔。 |
StartTime | String | 否 | 2017-12-10T14:00:00Z | 起始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 說明 支持查詢最近90天的數(shù)據(jù)。 |
EndTime | String | 否 | 2017-12-10T15:00:00Z | 結束時間。需晚于起始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
Interval | String | 否 | 300 | 查詢數(shù)據(jù)的時間粒度。單位:秒。取值:
說明 不傳或傳值不支持時,使用默認值300秒。 |
IspNameEn | String | 否 | alibaba | 運營商英文名。通過DescribeCdnRegionAndIsp獲得,不傳為所有運營商。 |
LocationNameEn | String | 否 | tianjin | 區(qū)域英文名。通過DescribeCdnRegionAndIsp獲得,不傳為所有區(qū)域。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
EndTime | String | 2017-12-10T15:00:00Z | 結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
StartTime | String | 2017-12-10T14:00:00Z | 起始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
RequestId | String | B955107D-E658-4E77-B913-E0AC3D31693E | 請求ID。 |
DomainName | String | example.com | 播流域名。 |
DataInterval | String | 300 | 查詢數(shù)據(jù)的時間粒度。 |
TrafficDataPerInterval | Array of DataModule | 每個時間間隔的流量數(shù)據(jù)。 |
|
DataModule | |||
TrafficValue | String | 454680793 | 總流量。單位:Byte。 |
HttpTrafficValue | String | 0 | HTTP流量。單位:Byte。 |
TimeStamp | String | 2017-12-10T15:00:05Z | 時間片起始時刻。 |
HttpsTrafficValue | String | 454680793 | HTTPS流量。單位:Byte。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainTrafficData
&<公共請求參數(shù)>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<DescribeLiveDomainTrafficDataResponse>
<EndTime>2017-12-10T15:00:00Z</EndTime>
<RequestId>B955107D-E658-4E77-B913-E0AC3D31693E</RequestId>
<DomainName>example.com</DomainName>
<TrafficDataPerInterval>
<DataModule>
<HttpTrafficValue>0</HttpTrafficValue>
<HttpsTrafficValue>454680793</HttpsTrafficValue>
<TrafficValue>454680793</TrafficValue>
<TimeStamp>2017-12-10T15:00:05Z</TimeStamp>
</DataModule>
</TrafficDataPerInterval>
<DataInterval>300</DataInterval>
<StartTime>2017-12-10T14:00:00Z</StartTime>
</DescribeLiveDomainTrafficDataResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DescribeLiveDomainTrafficDataResponse" : {
"EndTime" : "2017-12-10T15:00:00Z",
"RequestId" : "B955107D-E658-4E77-B913-E0AC3D31693E",
"DomainName" : "example.com",
"TrafficDataPerInterval" : {
"DataModule" : {
"HttpTrafficValue" : 0,
"HttpsTrafficValue" : 454680793,
"TrafficValue" : 454680793,
"TimeStamp" : "2017-12-10T15:00:05Z"
}
},
"DataInterval" : 300,
"StartTime" : "2017-12-10T14:00:00Z"
}
}
錯誤碼
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime參數(shù)錯誤,請您確認該StartTime參數(shù)是否正確。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間錯誤,請您確認結束時間是否正確。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 結束時間與開始時間不匹配,請您確認時間的匹配度。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 傳入的StartTime參數(shù)不支持。 |
訪問錯誤中心查看更多錯誤碼。