Retrieves the top data from WAF event analysis for a website.
Operation description
-
If you do not specify StartTime or EndTime, this operation returns data from the past 24 hours. If you specify StartTime and EndTime, this operation returns data for the specified time range.
-
Because of the high volume of access requests during the query period, data analytics may involve sampling.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| SiteId |
string |
No |
The site ID. You can call the ListSites operation to obtain the site ID. If this parameter is left empty, user-level data is queried. |
1150376036***** |
| StartTime |
string |
No |
The beginning of the time range to query. Specify the time in ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC+0. |
2023-04-08T16:00:00Z |
| EndTime |
string |
No |
The end of the time range to query. Specify the time in ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC+0. Note
The end time must be later than the start time. |
2023-04-09T16:00:00Z |
| Interval |
string |
No |
The time granularity for querying data. Unit: seconds. |
300 |
| Fields |
array<object> |
Yes |
The query metrics. |
|
|
object |
No |
The query metrics. |
||
| FieldName |
string |
No |
The query metric value. Note
For specific dimensions, see Data analytics field description. |
Requests |
| Dimension |
array |
No |
The query dimension. |
|
|
string |
No |
The query dimension. Note
For specific dimensions, see Data analytics field description. |
ALL |
|
| Limit |
string |
No |
The number of top data entries to query. Valid values:
|
5 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| Data |
array<object> |
The returned data. |
|
|
array<object> |
The returned data. |
||
| FieldName |
string |
The query metric value. |
Requests |
| DimensionName |
string |
The query dimension. |
ALL |
| DetailData |
array<object> |
The returned data. |
|
|
object |
The returned data. |
||
| DimensionValue |
string |
ALL |
|
| Value |
any |
123 |
|
| RequestId |
string |
The request ID. |
64041D4F-B615-5DEB-AC94-F01EE433**** |
| StartTime |
string |
The beginning of the time range to query. Specify the time in ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC+0. |
2023-04-08T16:00:00Z |
| EndTime |
string |
The end of the time range for the returned data. The time is in ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is in UTC+0. |
2023-04-09T16:00:00Z |
| SamplingRate |
number |
The sampling rate. Unit: %. |
100 |
Examples
Success response
JSON format
{
"Data": [
{
"FieldName": "Requests",
"DimensionName": "ALL",
"DetailData": [
{
"DimensionValue": "ALL",
"Value": "123"
}
]
}
],
"RequestId": "64041D4F-B615-5DEB-AC94-F01EE433****",
"StartTime": "2023-04-08T16:00:00Z",
"EndTime": "2023-04-09T16:00:00Z",
"SamplingRate": 100
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter.TimeRange | The specified time range exceeds the limit. Adjust it and try again. | The specified time range exceeds the limit. Adjust it and try again. |
| 400 | TooManyRequests | Too many requests.Please try again later. | Requests are too frequent, please try again later. |
| 400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | The end time you entered is earlier than the start time. Please check and try again. |
| 400 | InvalidParameter | Parameter verification failed. Check your configurations and try again. | Parameter verification failed. Check your configurations and try again. |
| 400 | QuotaCheckFailed.Function | The feature is unavailable in your plan. Upgrade the plan or contact your account manager to request the feature. | The feature is unavailable in your plan. Upgrade the plan or contact your account manager to request the feature. |
| 400 | InvalidParameter.Field | The specified Field is invalid. | The specified Field is invalid. For more information, see OpenAPI Documentation . |
| 400 | InvalidParameter.Dimension | The specified Dimension is invalid. | The specified Dimension is invalid. For more information, see OpenAPI Documentation . |
| 400 | InvalidTime.Malformed | Specified start time or end time is malformed. | The specified time format is incorrect. The time must conform to the yyyy-MM-ddTHH:mm:ssZ format. Please enter it correctly and try again. |
| 400 | TooManyDimensions | Too many query dimensions specified. Delete some and try again. | Too many query dimensions specified. Delete some and try again. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.