aws-sdk-wafv2 1.125.0 → 1.126.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e47a9f752ab0aae5986f5e12311f74db6baaeb0827ba01104d62bc4e67fe5c6
-  data.tar.gz: 16561abce1db359904d9bb401fd965bcc97260669fc58756555ba3c18e9bd469
+  metadata.gz: eb9bc8881386e551dce443f2dfa93c69b52c8a669689bb1f7c4d3a2aebd0a096
+  data.tar.gz: a32a1a23249d0079be9e10267ccaefa2451d14d567277cd5fd852466ccbb1257
 SHA512:
-  metadata.gz: 68f37f780969200c028d625e5d27b37c6c4a1f458d34f3c61b1737d0c972c965feda80c51e47eb6a1c539075d7b55517c76ffe09fffa5cfb1bcebd81b4bc2d1d
-  data.tar.gz: f2c29602420c87525278abb8b71737c7d42ed21a39e738a02d111250695cb5ecf254ae9479abd67dcf8082a24bea08c84d86020aff2d9533c6b825f69682d632
+  metadata.gz: a91dd15acd7b0b4466896ead8325bd3eb026baaf805b661d6acf4e1e6e83503158ca9b6b5e3eb3d632abdfee1fa86fa3d69a6840fb9c43427eb931abdc697123
+  data.tar.gz: e02b6ab1977d39c5eea65422e494f77320b0983de3668dc730eba11e16704dccbe31a21364726b569342dd237f00aeb191bea137ffe3af5fe2e9746eaad21c62

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.126.0 (2026-02-25)
+------------------
+
+* Feature - AWS WAF now supports GetTopPathStatisticsByTraffic that provides aggregated statistics on the top URI paths accessed by bot traffic. Use this operation to see which paths receive the most bot traffic, identify the specific bots accessing them, and filter by category, organization, or bot name.
+
 1.125.0 (2026-01-16)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.125.0
+1.126.0

data/lib/aws-sdk-wafv2/client.rb

@@ -5662,6 +5662,131 @@ module Aws::WAFV2
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # @option params [required, String] :web_acl_arn
+    #   The Amazon Resource Name (ARN) of the web ACL for which you want to
+    #   retrieve path statistics.
+    #
+    # @option params [required, String] :scope
+    #   Specifies whether the web ACL is for an Amazon Web Services CloudFront
+    #   distribution or for a regional application. A regional application can
+    #   be an Application Load Balancer, an AppSync GraphQL API, an Amazon
+    #   Cognito user pool, an Amazon Web Services App Runner service, or an
+    #   Amazon Web Services Verified Access instance.
+    #
+    # @option params [String] :uri_path_prefix
+    #   A URI path prefix to filter the results. When you specify this
+    #   parameter, the operation returns statistics for individual URIs within
+    #   the specified path prefix. For example, if you specify `/api`, the
+    #   response includes statistics for paths like `/api/v1/users` and
+    #   `/api/v2/orders`. If you don't specify this parameter, the operation
+    #   returns top-level path statistics.
+    #
+    # @option params [required, Types::TimeWindow] :time_window
+    #   The time window for which you want to retrieve path statistics. The
+    #   time window must be within the data retention period for your web ACL.
+    #
+    # @option params [String] :bot_category
+    #   Filters the results to include only traffic from bots in the specified
+    #   category. For example, you can filter by `ai` to see only AI crawler
+    #   traffic, or `search_engine` to see only search engine bot traffic.
+    #   When you apply this filter, the `Source` field is populated in the
+    #   response.
+    #
+    # @option params [String] :bot_organization
+    #   Filters the results to include only traffic from bots belonging to the
+    #   specified organization. For example, you can filter by `openai` or
+    #   `google`. When you apply this filter, the `Source` field is populated
+    #   in the response.
+    #
+    # @option params [String] :bot_name
+    #   Filters the results to include only traffic from the specified bot.
+    #   For example, you can filter by `gptbot` or `googlebot`. When you apply
+    #   this filter, the `Source` field is populated in the response.
+    #
+    # @option params [required, Integer] :limit
+    #   The maximum number of path statistics to return. Valid values are 1 to
+    #   100.
+    #
+    # @option params [required, Integer] :number_of_top_traffic_bots_per_path
+    #   The maximum number of top bots to include in the statistics for each
+    #   path. Valid values are 1 to 10.
+    #
+    # @option params [String] :next_marker
+    #   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.
+    #
+    # @return [Types::GetTopPathStatisticsByTrafficResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetTopPathStatisticsByTrafficResponse#path_statistics #path_statistics} => Array<Types::PathStatistics>
+    #   * {Types::GetTopPathStatisticsByTrafficResponse#total_request_count #total_request_count} => Integer
+    #   * {Types::GetTopPathStatisticsByTrafficResponse#next_marker #next_marker} => String
+    #   * {Types::GetTopPathStatisticsByTrafficResponse#top_categories #top_categories} => Array<Types::PathStatistics>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_top_path_statistics_by_traffic({
+    #     web_acl_arn: "ResourceArn", # required
+    #     scope: "CLOUDFRONT", # required, accepts CLOUDFRONT, REGIONAL
+    #     uri_path_prefix: "UriPathPrefixString",
+    #     time_window: { # required
+    #       start_time: Time.now, # required
+    #       end_time: Time.now, # required
+    #     },
+    #     bot_category: "FilterString",
+    #     bot_organization: "FilterString",
+    #     bot_name: "FilterString",
+    #     limit: 1, # required
+    #     number_of_top_traffic_bots_per_path: 1, # required
+    #     next_marker: "NextMarker",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.path_statistics #=> Array
+    #   resp.path_statistics[0].source.bot_category #=> String
+    #   resp.path_statistics[0].source.bot_organization #=> String
+    #   resp.path_statistics[0].source.bot_name #=> String
+    #   resp.path_statistics[0].path #=> String
+    #   resp.path_statistics[0].request_count #=> Integer
+    #   resp.path_statistics[0].percentage #=> Float
+    #   resp.path_statistics[0].top_bots #=> Array
+    #   resp.path_statistics[0].top_bots[0].bot_name #=> String
+    #   resp.path_statistics[0].top_bots[0].request_count #=> Integer
+    #   resp.path_statistics[0].top_bots[0].percentage #=> Float
+    #   resp.total_request_count #=> Integer
+    #   resp.next_marker #=> String
+    #   resp.top_categories #=> Array
+    #   resp.top_categories[0].source.bot_category #=> String
+    #   resp.top_categories[0].source.bot_organization #=> String
+    #   resp.top_categories[0].source.bot_name #=> String
+    #   resp.top_categories[0].path #=> String
+    #   resp.top_categories[0].request_count #=> Integer
+    #   resp.top_categories[0].percentage #=> Float
+    #   resp.top_categories[0].top_bots #=> Array
+    #   resp.top_categories[0].top_bots[0].bot_name #=> String
+    #   resp.top_categories[0].top_bots[0].request_count #=> Integer
+    #   resp.top_categories[0].top_bots[0].percentage #=> Float
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/GetTopPathStatisticsByTraffic AWS API Documentation
+    #
+    # @overload get_top_path_statistics_by_traffic(params = {})
+    # @param [Hash] params ({})
+    def get_top_path_statistics_by_traffic(params = {}, options = {})
+      req = build_request(:get_top_path_statistics_by_traffic, params)
+      req.send_request(options)
+    end
+
     # Retrieves the specified WebACL.
     #
     # @option params [String] :name
@@ -9642,7 +9767,7 @@ module Aws::WAFV2
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-wafv2'
-      context[:gem_version] = '1.125.0'
+      context[:gem_version] = '1.126.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-wafv2/client_api.rb

@@ -49,6 +49,8 @@ module Aws::WAFV2
     Body = Shapes::StructureShape.new(name: 'Body')
     BodyParsingFallbackBehavior = Shapes::StringShape.new(name: 'BodyParsingFallbackBehavior')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
+    BotStatistics = Shapes::StructureShape.new(name: 'BotStatistics')
+    BotStatisticsList = Shapes::ListShape.new(name: 'BotStatisticsList')
     ByteMatchStatement = Shapes::StructureShape.new(name: 'ByteMatchStatement')
     CapacityUnit = Shapes::IntegerShape.new(name: 'CapacityUnit')
     CaptchaAction = Shapes::StructureShape.new(name: 'CaptchaAction')
@@ -147,6 +149,8 @@ module Aws::WAFV2
     Filter = Shapes::StructureShape.new(name: 'Filter')
     FilterBehavior = Shapes::StringShape.new(name: 'FilterBehavior')
     FilterRequirement = Shapes::StringShape.new(name: 'FilterRequirement')
+    FilterSource = Shapes::StructureShape.new(name: 'FilterSource')
+    FilterString = Shapes::StringShape.new(name: 'FilterString')
     Filters = Shapes::ListShape.new(name: 'Filters')
     FirewallManagerRuleGroup = Shapes::StructureShape.new(name: 'FirewallManagerRuleGroup')
     FirewallManagerRuleGroups = Shapes::ListShape.new(name: 'FirewallManagerRuleGroups')
@@ -177,6 +181,8 @@ module Aws::WAFV2
     GetRuleGroupResponse = Shapes::StructureShape.new(name: 'GetRuleGroupResponse')
     GetSampledRequestsRequest = Shapes::StructureShape.new(name: 'GetSampledRequestsRequest')
     GetSampledRequestsResponse = Shapes::StructureShape.new(name: 'GetSampledRequestsResponse')
+    GetTopPathStatisticsByTrafficRequest = Shapes::StructureShape.new(name: 'GetTopPathStatisticsByTrafficRequest')
+    GetTopPathStatisticsByTrafficResponse = Shapes::StructureShape.new(name: 'GetTopPathStatisticsByTrafficResponse')
     GetWebACLForResourceRequest = Shapes::StructureShape.new(name: 'GetWebACLForResourceRequest')
     GetWebACLForResourceResponse = Shapes::StructureShape.new(name: 'GetWebACLForResourceResponse')
     GetWebACLRequest = Shapes::StructureShape.new(name: 'GetWebACLRequest')
@@ -274,6 +280,7 @@ module Aws::WAFV2
     NextMarker = Shapes::StringShape.new(name: 'NextMarker')
     NoneAction = Shapes::StructureShape.new(name: 'NoneAction')
     NotStatement = Shapes::StructureShape.new(name: 'NotStatement')
+    NumberOfTopTrafficBotsPerPath = Shapes::IntegerShape.new(name: 'NumberOfTopTrafficBotsPerPath')
     OnSourceDDoSProtectionConfig = Shapes::StructureShape.new(name: 'OnSourceDDoSProtectionConfig')
     OrStatement = Shapes::StructureShape.new(name: 'OrStatement')
     OutputUrl = Shapes::StringShape.new(name: 'OutputUrl')
@@ -283,7 +290,12 @@ module Aws::WAFV2
     ParameterExceptionField = Shapes::StringShape.new(name: 'ParameterExceptionField')
     ParameterExceptionParameter = Shapes::StringShape.new(name: 'ParameterExceptionParameter')
     PasswordField = Shapes::StructureShape.new(name: 'PasswordField')
+    PathStatistics = Shapes::StructureShape.new(name: 'PathStatistics')
+    PathStatisticsLimit = Shapes::IntegerShape.new(name: 'PathStatisticsLimit')
+    PathStatisticsList = Shapes::ListShape.new(name: 'PathStatisticsList')
+    PathString = Shapes::StringShape.new(name: 'PathString')
     PayloadType = Shapes::StringShape.new(name: 'PayloadType')
+    PercentageValue = Shapes::FloatShape.new(name: 'PercentageValue')
     PhoneNumberField = Shapes::StructureShape.new(name: 'PhoneNumberField')
     PhoneNumberFields = Shapes::ListShape.new(name: 'PhoneNumberFields')
     Platform = Shapes::StringShape.new(name: 'Platform')
@@ -336,6 +348,7 @@ module Aws::WAFV2
     ReleaseSummary = Shapes::StructureShape.new(name: 'ReleaseSummary')
     RequestBody = Shapes::MapShape.new(name: 'RequestBody')
     RequestBodyAssociatedResourceTypeConfig = Shapes::StructureShape.new(name: 'RequestBodyAssociatedResourceTypeConfig')
+    RequestCount = Shapes::IntegerShape.new(name: 'RequestCount')
     RequestInspection = Shapes::StructureShape.new(name: 'RequestInspection')
     RequestInspectionACFP = Shapes::StructureShape.new(name: 'RequestInspectionACFP')
     RequiredPricingPlanName = Shapes::StringShape.new(name: 'RequiredPricingPlanName')
@@ -426,6 +439,7 @@ module Aws::WAFV2
     UpdateWebACLResponse = Shapes::StructureShape.new(name: 'UpdateWebACLResponse')
     UriFragment = Shapes::StructureShape.new(name: 'UriFragment')
     UriPath = Shapes::StructureShape.new(name: 'UriPath')
+    UriPathPrefixString = Shapes::StringShape.new(name: 'UriPathPrefixString')
     UsageOfAction = Shapes::StringShape.new(name: 'UsageOfAction')
     UsernameField = Shapes::StructureShape.new(name: 'UsernameField')
     VendorName = Shapes::StringShape.new(name: 'VendorName')
@@ -539,6 +553,13 @@ module Aws::WAFV2
     Body.add_member(:oversize_handling, Shapes::ShapeRef.new(shape: OversizeHandling, location_name: "OversizeHandling"))
     Body.struct_class = Types::Body
 
+    BotStatistics.add_member(:bot_name, Shapes::ShapeRef.new(shape: FilterString, required: true, location_name: "BotName"))
+    BotStatistics.add_member(:request_count, Shapes::ShapeRef.new(shape: RequestCount, required: true, location_name: "RequestCount"))
+    BotStatistics.add_member(:percentage, Shapes::ShapeRef.new(shape: PercentageValue, required: true, location_name: "Percentage"))
+    BotStatistics.struct_class = Types::BotStatistics
+
+    BotStatisticsList.member = Shapes::ShapeRef.new(shape: BotStatistics)
+
     ByteMatchStatement.add_member(:search_string, Shapes::ShapeRef.new(shape: SearchString, required: true, location_name: "SearchString"))
     ByteMatchStatement.add_member(:field_to_match, Shapes::ShapeRef.new(shape: FieldToMatch, required: true, location_name: "FieldToMatch"))
     ByteMatchStatement.add_member(:text_transformations, Shapes::ShapeRef.new(shape: TextTransformations, required: true, location_name: "TextTransformations"))
@@ -833,6 +854,11 @@ module Aws::WAFV2
     Filter.add_member(:conditions, Shapes::ShapeRef.new(shape: Conditions, required: true, location_name: "Conditions"))
     Filter.struct_class = Types::Filter
 
+    FilterSource.add_member(:bot_category, Shapes::ShapeRef.new(shape: FilterString, location_name: "BotCategory"))
+    FilterSource.add_member(:bot_organization, Shapes::ShapeRef.new(shape: FilterString, location_name: "BotOrganization"))
+    FilterSource.add_member(:bot_name, Shapes::ShapeRef.new(shape: FilterString, location_name: "BotName"))
+    FilterSource.struct_class = Types::FilterSource
+
     Filters.member = Shapes::ShapeRef.new(shape: Filter)
 
     FirewallManagerRuleGroup.add_member(:name, Shapes::ShapeRef.new(shape: EntityName, required: true, location_name: "Name"))
@@ -952,6 +978,24 @@ module Aws::WAFV2
     GetSampledRequestsResponse.add_member(:time_window, Shapes::ShapeRef.new(shape: TimeWindow, location_name: "TimeWindow"))
     GetSampledRequestsResponse.struct_class = Types::GetSampledRequestsResponse
 
+    GetTopPathStatisticsByTrafficRequest.add_member(:web_acl_arn, Shapes::ShapeRef.new(shape: ResourceArn, required: true, location_name: "WebAclArn"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:scope, Shapes::ShapeRef.new(shape: Scope, required: true, location_name: "Scope"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:uri_path_prefix, Shapes::ShapeRef.new(shape: UriPathPrefixString, location_name: "UriPathPrefix"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:time_window, Shapes::ShapeRef.new(shape: TimeWindow, required: true, location_name: "TimeWindow"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:bot_category, Shapes::ShapeRef.new(shape: FilterString, location_name: "BotCategory"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:bot_organization, Shapes::ShapeRef.new(shape: FilterString, location_name: "BotOrganization"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:bot_name, Shapes::ShapeRef.new(shape: FilterString, location_name: "BotName"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:limit, Shapes::ShapeRef.new(shape: PathStatisticsLimit, required: true, location_name: "Limit"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:number_of_top_traffic_bots_per_path, Shapes::ShapeRef.new(shape: NumberOfTopTrafficBotsPerPath, required: true, location_name: "NumberOfTopTrafficBotsPerPath"))
+    GetTopPathStatisticsByTrafficRequest.add_member(:next_marker, Shapes::ShapeRef.new(shape: NextMarker, location_name: "NextMarker"))
+    GetTopPathStatisticsByTrafficRequest.struct_class = Types::GetTopPathStatisticsByTrafficRequest
+
+    GetTopPathStatisticsByTrafficResponse.add_member(:path_statistics, Shapes::ShapeRef.new(shape: PathStatisticsList, required: true, location_name: "PathStatistics"))
+    GetTopPathStatisticsByTrafficResponse.add_member(:total_request_count, Shapes::ShapeRef.new(shape: RequestCount, required: true, location_name: "TotalRequestCount"))
+    GetTopPathStatisticsByTrafficResponse.add_member(:next_marker, Shapes::ShapeRef.new(shape: NextMarker, location_name: "NextMarker"))
+    GetTopPathStatisticsByTrafficResponse.add_member(:top_categories, Shapes::ShapeRef.new(shape: PathStatisticsList, location_name: "TopCategories"))
+    GetTopPathStatisticsByTrafficResponse.struct_class = Types::GetTopPathStatisticsByTrafficResponse
+
     GetWebACLForResourceRequest.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, required: true, location_name: "ResourceArn"))
     GetWebACLForResourceRequest.struct_class = Types::GetWebACLForResourceRequest
 
@@ -1293,6 +1337,15 @@ module Aws::WAFV2
     PasswordField.add_member(:identifier, Shapes::ShapeRef.new(shape: FieldIdentifier, required: true, location_name: "Identifier"))
     PasswordField.struct_class = Types::PasswordField
 
+    PathStatistics.add_member(:source, Shapes::ShapeRef.new(shape: FilterSource, location_name: "Source"))
+    PathStatistics.add_member(:path, Shapes::ShapeRef.new(shape: PathString, required: true, location_name: "Path"))
+    PathStatistics.add_member(:request_count, Shapes::ShapeRef.new(shape: RequestCount, required: true, location_name: "RequestCount"))
+    PathStatistics.add_member(:percentage, Shapes::ShapeRef.new(shape: PercentageValue, required: true, location_name: "Percentage"))
+    PathStatistics.add_member(:top_bots, Shapes::ShapeRef.new(shape: BotStatisticsList, location_name: "TopBots"))
+    PathStatistics.struct_class = Types::PathStatistics
+
+    PathStatisticsList.member = Shapes::ShapeRef.new(shape: PathStatistics)
+
     PhoneNumberField.add_member(:identifier, Shapes::ShapeRef.new(shape: FieldIdentifier, required: true, location_name: "Identifier"))
     PhoneNumberField.struct_class = Types::PhoneNumberField
 
@@ -2258,6 +2311,19 @@ module Aws::WAFV2
         o.errors << Shapes::ShapeRef.new(shape: WAFInvalidParameterException)
       end)
 
+      api.add_operation(:get_top_path_statistics_by_traffic, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetTopPathStatisticsByTraffic"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetTopPathStatisticsByTrafficRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetTopPathStatisticsByTrafficResponse)
+        o.errors << Shapes::ShapeRef.new(shape: WAFInternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: WAFInvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: WAFNonexistentItemException)
+        o.errors << Shapes::ShapeRef.new(shape: WAFInvalidOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: WAFFeatureNotIncludedInPricingPlanException)
+      end)
+
       api.add_operation(:get_web_acl, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetWebACL"
         o.http_method = "POST"

data/lib/aws-sdk-wafv2/types.rb

@@ -699,6 +699,33 @@ module Aws::WAFV2
       include Aws::Structure
     end
 
+    # Statistics about a specific bot's traffic to a path, including the
+    # bot name, request count, and percentage of traffic.
+    #
+    # @!attribute [rw] bot_name
+    #   The name of the bot. For example, `gptbot` or `googlebot`.
+    #   @return [String]
+    #
+    # @!attribute [rw] request_count
+    #   The number of requests from this bot to the associated path within
+    #   the specified time window.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] percentage
+    #   The percentage of total requests to the associated path that came
+    #   from this bot.
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/BotStatistics AWS API Documentation
+    #
+    class BotStatistics < Struct.new(
+      :bot_name,
+      :request_count,
+      :percentage)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A rule statement that defines a string match search for WAF to apply
     # to web requests. The byte match statement provides the bytes to search
     # for, the location in requests that you want WAF to search, and other
@@ -3088,6 +3115,35 @@ module Aws::WAFV2
       include Aws::Structure
     end
 
+    # Information about the bot filter that was applied to the request. This
+    # structure is populated in the response when you filter by bot
+    # category, organization, or name.
+    #
+    # @!attribute [rw] bot_category
+    #   The bot category that was used to filter the results. For example,
+    #   `ai` or `search_engine`.
+    #   @return [String]
+    #
+    # @!attribute [rw] bot_organization
+    #   The bot organization that was used to filter the results. For
+    #   example, `OpenAI` or `Google`.
+    #   @return [String]
+    #
+    # @!attribute [rw] bot_name
+    #   The bot name that was used to filter the results. For example,
+    #   `gptbot` or `googlebot`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/FilterSource AWS API Documentation
+    #
+    class FilterSource < Struct.new(
+      :bot_category,
+      :bot_organization,
+      :bot_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A rule group that's defined for an Firewall Manager WAF policy.
     #
     # @!attribute [rw] name
@@ -3882,6 +3938,127 @@ module Aws::WAFV2
       include Aws::Structure
     end
 
+    # @!attribute [rw] web_acl_arn
+    #   The Amazon Resource Name (ARN) of the web ACL for which you want to
+    #   retrieve path statistics.
+    #   @return [String]
+    #
+    # @!attribute [rw] scope
+    #   Specifies whether the web ACL is for an Amazon Web Services
+    #   CloudFront distribution or for a regional application. A regional
+    #   application can be an Application Load Balancer, an AppSync GraphQL
+    #   API, an Amazon Cognito user pool, an Amazon Web Services App Runner
+    #   service, or an Amazon Web Services Verified Access instance.
+    #   @return [String]
+    #
+    # @!attribute [rw] uri_path_prefix
+    #   A URI path prefix to filter the results. When you specify this
+    #   parameter, the operation returns statistics for individual URIs
+    #   within the specified path prefix. For example, if you specify
+    #   `/api`, the response includes statistics for paths like
+    #   `/api/v1/users` and `/api/v2/orders`. If you don't specify this
+    #   parameter, the operation returns top-level path statistics.
+    #   @return [String]
+    #
+    # @!attribute [rw] time_window
+    #   The time window for which you want to retrieve path statistics. The
+    #   time window must be within the data retention period for your web
+    #   ACL.
+    #   @return [Types::TimeWindow]
+    #
+    # @!attribute [rw] bot_category
+    #   Filters the results to include only traffic from bots in the
+    #   specified category. For example, you can filter by `ai` to see only
+    #   AI crawler traffic, or `search_engine` to see only search engine bot
+    #   traffic. When you apply this filter, the `Source` field is populated
+    #   in the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] bot_organization
+    #   Filters the results to include only traffic from bots belonging to
+    #   the specified organization. For example, you can filter by `openai`
+    #   or `google`. When you apply this filter, the `Source` field is
+    #   populated in the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] bot_name
+    #   Filters the results to include only traffic from the specified bot.
+    #   For example, you can filter by `gptbot` or `googlebot`. When you
+    #   apply this filter, the `Source` field is populated in the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] limit
+    #   The maximum number of path statistics to return. Valid values are 1
+    #   to 100.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] number_of_top_traffic_bots_per_path
+    #   The maximum number of top bots to include in the statistics for each
+    #   path. Valid values are 1 to 10.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_marker
+    #   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.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/GetTopPathStatisticsByTrafficRequest AWS API Documentation
+    #
+    class GetTopPathStatisticsByTrafficRequest < Struct.new(
+      :web_acl_arn,
+      :scope,
+      :uri_path_prefix,
+      :time_window,
+      :bot_category,
+      :bot_organization,
+      :bot_name,
+      :limit,
+      :number_of_top_traffic_bots_per_path,
+      :next_marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] path_statistics
+    #   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.
+    #   @return [Array<Types::PathStatistics>]
+    #
+    # @!attribute [rw] total_request_count
+    #   The total number of requests that match the query criteria within
+    #   the specified time window.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_marker
+    #   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.
+    #   @return [String]
+    #
+    # @!attribute [rw] top_categories
+    #   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.
+    #   @return [Array<Types::PathStatistics>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/GetTopPathStatisticsByTrafficResponse AWS API Documentation
+    #
+    class GetTopPathStatisticsByTrafficResponse < Struct.new(
+      :path_statistics,
+      :total_request_count,
+      :next_marker,
+      :top_categories)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] resource_arn
     #   The Amazon Resource Name (ARN) of the resource whose web ACL you
     #   want to retrieve.
@@ -6633,6 +6810,47 @@ module Aws::WAFV2
       include Aws::Structure
     end
 
+    # Statistics about bot traffic to a specific URI path, including the
+    # path, request count, percentage of total traffic, and the top bots
+    # accessing that path.
+    #
+    # @!attribute [rw] source
+    #   Information about the bot filter that was applied to generate these
+    #   statistics. This field is only populated when you filter by bot
+    #   category, organization, or name.
+    #   @return [Types::FilterSource]
+    #
+    # @!attribute [rw] path
+    #   The URI path. For example, `/api/` or `/api/v1/users`.
+    #   @return [String]
+    #
+    # @!attribute [rw] request_count
+    #   The number of requests to this path within the specified time
+    #   window.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] percentage
+    #   The percentage of total requests that were made to this path.
+    #   @return [Float]
+    #
+    # @!attribute [rw] top_bots
+    #   The list of top bots accessing this path, ordered by request count.
+    #   The number of bots included is determined by the
+    #   `NumberOfTopTrafficBotsPerPath` parameter in the request.
+    #   @return [Array<Types::BotStatistics>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/PathStatistics AWS API Documentation
+    #
+    class PathStatistics < Struct.new(
+      :source,
+      :path,
+      :request_count,
+      :percentage,
+      :top_bots)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The name of a field in the request payload that contains part or all
     # of your customer's primary phone number.
     #

data/lib/aws-sdk-wafv2.rb

@@ -54,7 +54,7 @@ module Aws::WAFV2
   autoload :EndpointProvider, 'aws-sdk-wafv2/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-wafv2/endpoints'
 
-  GEM_VERSION = '1.125.0'
+  GEM_VERSION = '1.126.0'
 
 end
 

data/sig/client.rbs

@@ -3184,6 +3184,31 @@ module Aws
                                 ) -> _GetSampledRequestsResponseSuccess
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetSampledRequestsResponseSuccess
 
+      interface _GetTopPathStatisticsByTrafficResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetTopPathStatisticsByTrafficResponse]
+        def path_statistics: () -> ::Array[Types::PathStatistics]
+        def total_request_count: () -> ::Integer
+        def next_marker: () -> ::String
+        def top_categories: () -> ::Array[Types::PathStatistics]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/WAFV2/Client.html#get_top_path_statistics_by_traffic-instance_method
+      def get_top_path_statistics_by_traffic: (
+                                                web_acl_arn: ::String,
+                                                scope: ("CLOUDFRONT" | "REGIONAL"),
+                                                ?uri_path_prefix: ::String,
+                                                time_window: {
+                                                  start_time: ::Time,
+                                                  end_time: ::Time
+                                                },
+                                                ?bot_category: ::String,
+                                                ?bot_organization: ::String,
+                                                ?bot_name: ::String,
+                                                limit: ::Integer,
+                                                number_of_top_traffic_bots_per_path: ::Integer,
+                                                ?next_marker: ::String
+                                              ) -> _GetTopPathStatisticsByTrafficResponseSuccess
+                                            | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetTopPathStatisticsByTrafficResponseSuccess
+
       interface _GetWebACLResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetWebACLResponse]
         def web_acl: () -> Types::WebACL

data/sig/types.rbs

@@ -112,6 +112,13 @@ module Aws::WAFV2
       SENSITIVE: []
     end
 
+    class BotStatistics
+      attr_accessor bot_name: ::String
+      attr_accessor request_count: ::Integer
+      attr_accessor percentage: ::Float
+      SENSITIVE: []
+    end
+
     class ByteMatchStatement
       attr_accessor search_string: ::String
       attr_accessor field_to_match: Types::FieldToMatch
@@ -503,6 +510,13 @@ module Aws::WAFV2
       SENSITIVE: []
     end
 
+    class FilterSource
+      attr_accessor bot_category: ::String
+      attr_accessor bot_organization: ::String
+      attr_accessor bot_name: ::String
+      SENSITIVE: []
+    end
+
     class FirewallManagerRuleGroup
       attr_accessor name: ::String
       attr_accessor priority: ::Integer
@@ -670,6 +684,28 @@ module Aws::WAFV2
       SENSITIVE: []
     end
 
+    class GetTopPathStatisticsByTrafficRequest
+      attr_accessor web_acl_arn: ::String
+      attr_accessor scope: ("CLOUDFRONT" | "REGIONAL")
+      attr_accessor uri_path_prefix: ::String
+      attr_accessor time_window: Types::TimeWindow
+      attr_accessor bot_category: ::String
+      attr_accessor bot_organization: ::String
+      attr_accessor bot_name: ::String
+      attr_accessor limit: ::Integer
+      attr_accessor number_of_top_traffic_bots_per_path: ::Integer
+      attr_accessor next_marker: ::String
+      SENSITIVE: []
+    end
+
+    class GetTopPathStatisticsByTrafficResponse
+      attr_accessor path_statistics: ::Array[Types::PathStatistics]
+      attr_accessor total_request_count: ::Integer
+      attr_accessor next_marker: ::String
+      attr_accessor top_categories: ::Array[Types::PathStatistics]
+      SENSITIVE: []
+    end
+
     class GetWebACLForResourceRequest
       attr_accessor resource_arn: ::String
       SENSITIVE: []
@@ -1109,6 +1145,15 @@ module Aws::WAFV2
       SENSITIVE: []
     end
 
+    class PathStatistics
+      attr_accessor source: Types::FilterSource
+      attr_accessor path: ::String
+      attr_accessor request_count: ::Integer
+      attr_accessor percentage: ::Float
+      attr_accessor top_bots: ::Array[Types::BotStatistics]
+      SENSITIVE: []
+    end
+
     class PhoneNumberField
       attr_accessor identifier: ::String
       SENSITIVE: []

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-wafv2
 version: !ruby/object:Gem::Version
-  version: 1.125.0
+  version: 1.126.0
 platform: ruby
 authors:
 - Amazon Web Services