調用本介面查詢加速網域名稱的請求命中率資料。本介面支援查詢的資料時間粒紋最小為1分鐘,資料延遲最少為5分鐘,最長可查詢最近186天的資料。
介面說明
目前該介面服務地址僅支援:華東 2(上海)。
支援批量查詢,一次最多查詢 100 個網域名稱資料。
如果您不指定
StartTime和EndTime,該介面預設返回過去 1 小時的資料;指定StartTime和EndTime,該介面返回指定時間段的資料。Go 語言預設是用 POST 方式請求,需手動修改使用 GET 方式請求,聲明
request.Method="GET"。
返回資料時間粒紋
根據您指定StartTime和EndTime時間跨度,會返回不同的資料時間粒紋,對應的可查詢歷史資料時間範圍和資料延遲如下:
| 時間粒紋 | 單次查詢的時間跨度 | 可查詢歷史資料時間範圍 | 資料延遲 |
| 1 分鐘 | 單次查詢的時間跨度 ≤ 1 小時 | 7 天 | 5 分鐘 |
| 5 分鐘 | 1 小時 < 單次查詢的時間跨度 < 3 天 | 93 天 | 15 分鐘 |
| 1 小時 | 3 天 ≤ 單次查詢的時間跨度 < 31 天 | 186 天 | 一般延遲 3-4 小時 |
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vod:DescribeVodDomainRealTimeReqHitRateData |
get |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| DomainName |
string |
是 |
加速網域名稱,多個網域名稱用半形逗號(,)分隔,一次最多支援 100 個網域名稱查詢。查詢多個網域名稱時,返回的資料為各網域名稱合并後的資料值。 |
example.com |
| StartTime |
string |
否 |
擷取資料的起始時間點。日期格式按照 ISO8601 標記法,並使用 UTC 時間,格式為:yyyy-MM-ddTHH:mm:ssZ。 |
2024-01-02T11:23:00Z |
| EndTime |
string |
否 |
擷取資料的結束時間點。日期格式按照 ISO8601 標記法,並使用 UTC 時間,格式為:yyyy-MM-ddTHH:mm:ssZ。 說明
結束時間需大於起始時間。 |
2024-01-02T11:26:00Z |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
70A26B11-3673-479C-AEA8-E03FC5D3496D |
| Data |
object |
||
| ReqHitRateDataModel |
array<object> |
返回資料詳情。 |
|
|
object |
|||
| ReqHitRate |
number |
請求命中率(百分比資料)。 |
0.8956940476262277 |
| TimeStamp |
string |
資料時間戳記,日期格式按照 ISO8601 標記法,並使用 UTC 時間。 |
2024-01-02T11:26:00Z |
樣本
正常返回樣本
JSON格式
{
"RequestId": "70A26B11-3673-479C-AEA8-E03FC5D3496D",
"Data": {
"ReqHitRateDataModel": [
{
"ReqHitRate": 0.8956940476262277,
"TimeStamp": "2024-01-02T11:26:00Z"
}
]
}
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidTime.Malformed | Specified StartTime or EndTime is malformed. | |
| 400 | InvalidDomainName.Malformed | Specified domain name is malformed. | |
| 400 | InvalidParameter | The specified parameter is not valid. | 參數無效。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。