調用DescribeDomainRealTimeHttpCodeData查詢加速網域名稱HTTP返回碼的總數和佔比資料。
介面說明
如果您不指定 StartTime 和 EndTime,該介面預設返回過去 1 小時的資料;指定 StartTime 和 EndTime,該介面返回指定時間段的資料。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
cdn:DescribeDomainRealTimeHttpCodeData |
none |
*Domain
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| DomainName |
string |
是 |
加速網域名稱,多個網域名稱用半形逗號(,)分隔。 說明
一次最多可以傳 100 個網域名稱。 |
example.com,example.org |
| StartTime |
string |
否 |
擷取資料的起始時間點。 日期格式按照 ISO8601 標記法,並使用 UTC 時間,格式為 yyyy-MM-ddTHH:mm:ssZ。 |
2019-11-30T05:39:00Z |
| EndTime |
string |
否 |
擷取資料的結束時間點。 日期格式按照 ISO8601 標記法,並使用 UTC 時間,格式為 yyyy-MM-ddTHH:mm:ssZ。 說明
結束時間需大於起始時間。 |
2019-11-30T05:40:00Z |
| IspNameEn |
string |
否 |
電訊廠商英文名。通過 DescribeCdnRegionAndIsp 獲得,預設查詢所有電訊廠商。 |
unicom |
| LocationNameEn |
string |
否 |
地區英文名。通過 DescribeCdnRegionAndIsp 獲得,預設查詢所有地區。 |
beijing |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| EndTime |
string |
結束時間。 |
2019-11-29T05:42:00Z |
| StartTime |
string |
開始時間。 |
2019-11-29T05:39:00Z |
| RequestId |
string |
請求 ID。 |
BC858082-736F-4A25-867B-E5B67C85ACF7 |
| DomainName |
string |
加速網域名稱資訊。 |
example.com,example.org |
| DataInterval |
string |
每條記錄的時間間隔,單位:秒。 根據單次查詢的最大時間跨度不同,該參數固定返回 60(1 分鐘)、300(5 分鐘)或 3600(1 小時),具體請參見使用說明中返回資料時間粒紋。 |
60 |
| RealTimeHttpCodeData |
object |
||
| UsageData |
array<object> |
每個時間間隔的 HTTP 返回碼佔比資料。 |
|
|
array<object> |
|||
| TimeStamp |
string |
時間片起始時刻。 |
2019-11-29T05:39:00Z |
| Value |
object |
||
| RealTimeCodeProportionData |
array<object> |
各返回碼佔比使用資料列表。 |
|
|
object |
|||
| Code |
string |
HTTP 返回碼。 |
500 |
| Proportion |
string |
佔比使用資料。 |
28.4496124031008 |
| Count |
string |
總數。 |
100 |
樣本
正常返回樣本
JSON格式
{
"EndTime": "2019-11-29T05:42:00Z",
"StartTime": "2019-11-29T05:39:00Z",
"RequestId": "BC858082-736F-4A25-867B-E5B67C85ACF7",
"DomainName": "example.com,example.org",
"DataInterval": "60",
"RealTimeHttpCodeData": {
"UsageData": [
{
"TimeStamp": "2019-11-29T05:39:00Z",
"Value": {
"RealTimeCodeProportionData": [
{
"Code": "500",
"Proportion": "28.4496124031008",
"Count": "100"
}
]
}
}
]
}
}
異常返回樣本
JSON格式
{
"RealTimeHttpCodeData": {
"UsageData": [
{
"TimeStamp": "2015-11-30T05:40:00Z",
"Value": {
"RealTimeCodeProportionData": [
{
"Proportion": "66.046511627907",
"Code": "200"
},
{
"Proportion": "4.72868217054264",
"Code": "206"
},
{
"Proportion": "0.155038759689922",
"Code": "302"
},
{
"Proportion": "0.62015503875969",
"Code": "304"
},
{
"Proportion": "28.4496124031008",
"Code": "500"
}
]
}
},
{
"TimeStamp": "2015-11-30T05:39:00Z",
"Value": {
"RealTimeCodeProportionData": [
{
"Proportion": "66.046511627907",
"Code": "200"
},
{
"Proportion": "4.72868217054264",
"Code": "206"
},
{
"Proportion": "0.155038759689922",
"Code": "302"
},
{
"Proportion": "0.62015503875969",
"Code": "304"
},
{
"Proportion": "28.4496124031008",
"Code": "500"
}
]
}
}
]
},
"DataInterval": "60",
"RequestId": "BC858082-736F-4A25-867B-E5B67C85ACF7",
"DomainName": "example1.com,example2.com",
"EndTime": "2015-11-30T05:40:00Z",
"StartTime": "2015-11-30T05:33:00Z"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | 請同時提供開始時間和結束時間。 |
| 400 | InvalidStartTime.Malformed | The specified value of parameter StartTime is malformed. | |
| 400 | InvalidEndTime.Malformed | The specified value of parameter EndTime is malformed. | |
| 400 | InvalidEndTime.Mismatch | Specified EndTime does not match the specified StartTime. | 指定的EndTime與StartTime不匹配,StartTime應早於EndTime。 |
| 400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。