調用DescribeLiveDomainRealTimeBpsData獲取域名1分鐘粒度帶寬數據。
使用說明
- 調用本接口查詢指定域名的流量和帶寬使用情況。
- 可以查詢最近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"
}
}
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?