呼叫 DescribeDcdnDomainHttpCodeData 取得加速網域的 HTTP 狀態碼總數和佔比資料。
介面說明
不指定 StartTime 和 EndTime，預設返回過去 24 小時的資料；指定 StartTime 和 EndTime，該介面返回指定時間段的資料。
單一使用者呼叫頻率：100 次/秒。
支援查詢的時間粒度
根據單次查詢的最大時間跨度不同，請求參數 Interval 支援不同的查詢資料時間粒度，對應的可查詢歷史資料時間範圍和資料延遲如下：
| 時間粒度 | 單次查詢的最大時間跨度 | 可查詢歷史資料時間範圍 | 資料延遲 |
| 5 分鐘 | 3 天 | 93 天 | 15 分鐘 |
| 1 小時 | 31 天 | 186 天 | 一般延遲 3-4 小時 |
| 1 天 | 366 天 | 366 天 | 一般延遲 4 小時，不超過 24 小時 |
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
dcdn:DescribeDcdnDomainHttpCodeData |
get |
domain
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| DomainName |
string |
是 |
加速網域，多個網域用英文逗號（,）分隔。 |
example.com |
| StartTime |
string |
否 |
取得資料的起始時間點。 日期格式按照 ISO8601 表示法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。 |
2019-03-01T00:00:00Z |
| EndTime |
string |
否 |
取得資料的結束時間點。 日期格式按照 ISO8601 表示法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。 說明
結束時間需大於起始時間。 |
2019-03-02T00:00:00Z |
| Interval |
string |
否 |
查詢資料的時間粒度，單位為秒。 根據單次查詢的最大時間跨度不同，該參數支援 300（5 分鐘）、3600（1 小時）和 86400（1 天）取值，具體請參見使用說明中支援查詢的時間粒度。 |
300 |
| IspNameEn |
string |
否 |
營運商英文名。 您可以呼叫 DescribeDcdnRegionAndIsp 介面取得，預設查詢所有營運商。 |
unicom |
| LocationNameEn |
string |
否 |
地域英文名。 您可以呼叫 DescribeDcdnRegionAndIsp 介面取得，預設查詢所有地域。 |
beijing |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| EndTime |
string |
結束時間。 時間採用 ISO 8601 格式的 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。 |
2018-03-01T13:00:00Z |
| StartTime |
string |
開始時間。 時間採用 ISO 8601 格式的 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。 |
2019-03-01T00:00:00Z |
| RequestId |
string |
請求 ID。 |
91FC2D9D-B042-4634-8A5C-7B8E7482C22D |
| DomainName |
string |
加速網域資訊。 |
example.com |
| DataInterval |
string |
每條記錄的時間間隔，以秒為單位。 |
300 |
| DataPerInterval |
object |
||
| DataModule |
array<object> |
每個時間間隔的 HTTP 返回碼佔比資料。 |
|
|
array<object> |
|||
| TimeStamp |
string |
時間片起始時刻。 時間採用 ISO 8601 格式的 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。 |
2019-03-01T13:00:00Z |
| HttpCodeDataPerInterval |
object |
||
| HttpCodeDataModule |
array<object> |
各返回碼佔比使用資料清單。 |
|
|
object |
|||
| Code |
integer |
HTTP 返回碼。 |
404 |
| Proportion |
number |
佔比使用資料。 |
33.333333 |
| Count |
number |
總數。 |
1 |
樣本
正常返回樣本
JSON格式
{
"EndTime": "2018-03-01T13:00:00Z",
"StartTime": "2019-03-01T00:00:00Z",
"RequestId": "91FC2D9D-B042-4634-8A5C-7B8E7482C22D",
"DomainName": "example.com",
"DataInterval": "300",
"DataPerInterval": {
"DataModule": [
{
"TimeStamp": "2019-03-01T13:00:00Z",
"HttpCodeDataPerInterval": {
"HttpCodeDataModule": [
{
"Code": 404,
"Proportion": 33.333333,
"Count": 1
}
]
}
}
]
}
}錯誤碼
|
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. | 不支援該開始時間，請重新填寫。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。