Skip to content

GetRevenueStatisticsRequest

Source code in docs_src/capo_wafv2/types/get_revenue_statistics_request.py
class GetRevenueStatisticsRequest(TypedDict, closed=True):
    statistic_type: "capo_wafv2.types.ranking_statistic_type.RankingStatisticType"
    """<p> <code>TOP_SOURCES_BY_REVENUE</code> ranks revenue from AI bot traffic, grouped by the dimension you specify in the <code>GroupBy</code> parameter (<code>NAME</code>, <code>CATEGORY</code>, <code>INTENT</code>, <code>ORGANIZATION</code>, or <code>WEBACL</code>); <code>GroupBy</code> is required for this statistic type. <code>TOP_PATHS_BY_REVENUE</code> ranks revenue by path.</p>"""
    time_window: "capo_wafv2.types.time_window.TimeWindow"
    """<p>The time range for the query. Specify start and end timestamps.</p>"""
    scope: "capo_wafv2.types.scope.Scope"
    """<p>Specifies whether this is for a Amazon CloudFront distribution (<code>CLOUDFRONT</code>) or for a regional application (<code>REGIONAL</code>).</p>"""
    currency: "capo_wafv2.types.currency.Currency"
    """<p>The currency for the revenue amounts in the response.</p>"""
    group_by: NotRequired["capo_wafv2.types.group_by_type.GroupByType"]
    """<p>The dimension to group results by: <code>NAME</code>, <code>CATEGORY</code>, <code>INTENT</code>, <code>ORGANIZATION</code>, or <code>WEBACL</code>. Required when <code>StatisticType</code> is <code>TOP_SOURCES_BY_REVENUE</code>. Not required for <code>TOP_PATHS_BY_REVENUE</code>, where results are grouped by content path. If <code>StatisticType</code> is <code>TOP_SOURCES_BY_REVENUE</code> and <code>GroupBy</code> is omitted, the request is rejected with a <code>WAFInvalidParameterException</code>.</p>"""
    filters: NotRequired[
        "capo_wafv2.types.monetization_filter_list.MonetizationFilterList"
    ]
    """<p>Optional filters to narrow the results.</p>"""
    next_marker: NotRequired["capo_wafv2.types.next_marker.NextMarker"]
    """<p>When you get a paginated response, this marker indicates that additional results are available. Use it in a subsequent request to retrieve the next page of results.</p>"""
    limit: NotRequired["capo_wafv2.types.path_statistics_limit.PathStatisticsLimit"]
    """<p>The maximum number of results to return.</p>"""
    sort_by: NotRequired["capo_wafv2.types.ranking_sort_by.RankingSortBy"]
    """<p>The field to sort results by: <code>REVENUE</code>, <code>PERCENTAGE</code>, or <code>NAME</code>.</p>"""
    sort_order: NotRequired["capo_wafv2.types.sort_order.SortOrder"]
    """<p>The sort order: <code>ASC</code> for ascending or <code>DESC</code> for descending.</p>"""

currency instance-attribute

currency: Currency

The currency for the revenue amounts in the response.

filters instance-attribute

filters: NotRequired[MonetizationFilterList]

Optional filters to narrow the results.

group_by instance-attribute

group_by: NotRequired[GroupByType]

The dimension to group results by: NAME, CATEGORY, INTENT, ORGANIZATION, or WEBACL. Required when StatisticType is TOP_SOURCES_BY_REVENUE. Not required for TOP_PATHS_BY_REVENUE, where results are grouped by content path. If StatisticType is TOP_SOURCES_BY_REVENUE and GroupBy is omitted, the request is rejected with a WAFInvalidParameterException.

limit instance-attribute

limit: NotRequired[PathStatisticsLimit]

The maximum number of results to return.

next_marker instance-attribute

next_marker: NotRequired[NextMarker]

When you get a paginated response, this marker indicates that additional results are available. Use it in a subsequent request to retrieve the next page of results.

scope instance-attribute

scope: Scope

Specifies whether this is for a Amazon CloudFront distribution (CLOUDFRONT) or for a regional application (REGIONAL).

sort_by instance-attribute

sort_by: NotRequired[RankingSortBy]

The field to sort results by: REVENUE, PERCENTAGE, or NAME.

sort_order instance-attribute

sort_order: NotRequired[SortOrder]

The sort order: ASC for ascending or DESC for descending.

statistic_type instance-attribute

statistic_type: RankingStatisticType

TOP_SOURCES_BY_REVENUE ranks revenue from AI bot traffic, grouped by the dimension you specify in the GroupBy parameter (NAME, CATEGORY, INTENT, ORGANIZATION, or WEBACL); GroupBy is required for this statistic type. TOP_PATHS_BY_REVENUE ranks revenue by path.

time_window instance-attribute

time_window: TimeWindow

The time range for the query. Specify start and end timestamps.