top_path_statistics_by_traffics
Creates, updates, deletes, gets or lists a top_path_statistics_by_traffics resource.
Overview
| Name | top_path_statistics_by_traffics |
| Type | Resource |
| Id | aws.wafv2.top_path_statistics_by_traffics |
Fields
The following fields are returned by SELECT queries:
- get_top_path_statistics_by_traffic
| Name | Datatype | Description |
|---|---|---|
next_marker | string | When you request a list of objects with a Limit setting, if the number of objects that are still available for retrieval exceeds the limit, WAF returns a NextMarker value in the response. To retrieve the next batch of objects, provide the marker from the prior call in your next request. (pattern: <code>.\S.</code>) |
path_statistics | array | The list of path statistics, ordered by request count. Each entry includes the path, request count, percentage of total traffic, and the top bots accessing that path. |
top_categories | array | Category-level aggregations for visualizing bot category to path relationships. This field is only populated when no bot filters are applied to the request. Each entry includes the bot category and the paths accessed by bots in that category. |
total_request_count | integer (int64) | The total number of requests that match the query criteria within the specified time window. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_top_path_statistics_by_traffic | select | region | Retrieves aggregated statistics about the top URI paths accessed by bot traffic for a specified web ACL and time window. You can use this operation to analyze which paths on your web application receive the most bot traffic and identify the specific bots accessing those paths. The operation supports filtering by bot category, organization, or name, and allows you to drill down into specific path prefixes to view detailed URI-level statistics. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_top_path_statistics_by_traffic
Retrieves aggregated statistics about the top URI paths accessed by bot traffic for a specified web ACL and time window. You can use this operation to analyze which paths on your web application receive the most bot traffic and identify the specific bots accessing those paths. The operation supports filtering by bot category, organization, or name, and allows you to drill down into specific path prefixes to view detailed URI-level statistics.
SELECT
next_marker,
path_statistics,
top_categories,
total_request_count
FROM aws.wafv2.top_path_statistics_by_traffics
WHERE region = '{{ region }}' -- required
;