調用DescribeDcdnDomainRegionData查詢加速網域名稱天粒度的使用者地區分布資料統計,支援擷取90天的資料。
介面說明
當您不指定 StartTime 和 EndTime 時,預設讀取過去 24 小時的資料;指定 StartTime 和 EndTime 時,按指定的起止時間查詢。
單使用者調用頻率:100 次/秒。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
dcdn:DescribeDcdnDomainRegionData |
get |
*Domain
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| DomainName |
string |
否 |
加速網域名稱,僅支援一個網域名稱。 預設查詢目前使用者下所有網域名稱。 |
example.com |
| StartTime |
string |
否 |
擷取資料開始時間點。 北京時間,格式為 YYYY-MM-DDThh:mm:ssZ。 |
2015-12-05T12:00:00Z |
| EndTime |
string |
否 |
擷取資料結束時間點,結束時間需大於起始時間。 北京時間,格式為 YYYY-MM-DDThh:mm:ssZ。 |
2015-12-07T12:00:00Z |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| EndTime |
string |
結束時間。 |
2015-12-07T12:00:00Z |
| StartTime |
string |
開始時間。 |
2015-12-05T12:00:00Z |
| RequestId |
string |
請求 ID。 |
2E5AD83F-BD7B-462E-8319-2E30E305519A |
| DomainName |
string |
加速網域名稱資訊。 |
example.com |
| DataInterval |
string |
每條記錄的時間間隔,單位:秒。 |
86400 |
| Value |
object |
||
| RegionProportionData |
array<object> |
各地區訪問佔比資料列表。 |
|
|
object |
|||
| Qps |
string |
每秒查詢率。 |
0 |
| TotalQuery |
string |
總請求次數。 |
0 |
| TotalBytes |
string |
總流量。 |
0 |
| RegionEname |
string |
地區英文名稱。 |
chongqing |
| Region |
string |
地區資訊。 |
重慶市 |
| AvgResponseRate |
string |
平均響應速度,單位:byte/秒。 |
0 |
| AvgResponseTime |
string |
平均回應時間,單位:毫秒。 |
0 |
| Proportion |
string |
訪問佔比資料。例如:返回 90 即為 90% 。 |
0 |
| AvgObjectSize |
string |
響應平均大小,單位:byte。 |
0 |
| Bps |
string |
頻寬。 |
0 |
| BytesProportion |
string |
總流量佔比。例如:返回 90 即為 90%。 |
0.003544181046236794 |
樣本
正常返回樣本
JSON格式
{
"EndTime": "2015-12-07T12:00:00Z",
"StartTime": "2015-12-05T12:00:00Z",
"RequestId": "2E5AD83F-BD7B-462E-8319-2E30E305519A",
"DomainName": "example.com",
"DataInterval": "86400",
"Value": {
"RegionProportionData": [
{
"Qps": "0",
"TotalQuery": "0",
"TotalBytes": "0",
"RegionEname": "chongqing",
"Region": "重慶市",
"AvgResponseRate": "0",
"AvgResponseTime": "0",
"Proportion": "0",
"AvgObjectSize": "0",
"Bps": "0",
"BytesProportion": "0.003544181046236794"
}
]
}
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | 請同時提供開始時間和結束時間。 |
| 400 | InvalidStartTime.Malformed | The specified StartTime parameter is invalid. | 請提供正確的開始時間格式。日期格式按照ISO8601標記法,並使用UTC時間,格式為:yyyy-MM-ddTHH:mm:ssZ。 |
| 400 | InvalidEndTime.Malformed | The specified EndTime is invalid. | 請提供正確的結束時間格式。日期格式按照ISO8601標記法,並使用UTC時間。 格式為:yyyy-MM-ddTHH:mm:ssZ。 |
| 400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | 結束時間早於開始時間,請檢查。 |
| 400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | 不支援該開始時間,請重新填寫。 |
| 404 | InvalidDomain.NotFound | The specified domain does not exist. | 該網域名稱不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。