aws-sdk-waf 1.26.0 → 1.31.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 62e095759f2157af894a3fe1aef6c4e042129f1a
-  data.tar.gz: 2496f9ca47d618947ec6711f5362359c49299db7
+SHA256:
+  metadata.gz: 60c850b90d25c471d79f467b2b030f9a78c0d9d7e2ab7dfac4cf539c046f1dc9
+  data.tar.gz: a645ee4a97c5dc10de556895759c4ef6558fb65d958808544584bb4be5e34701
 SHA512:
-  metadata.gz: 564d5da5f9e1f88e4cf20eed630d1344eae58c93620db6696817a5ca801f566740e790eee5c05ccc263fa35b4d6f3d07f8631a0b632afe0bb03d0dcf3dc7cfd5
-  data.tar.gz: 3b4f193f492c50a1783d747f7aed3f82e755e91b6340cea8df8a63452917ed9c9ea00f0ad7404529967d655ec5838f9c3342de40f09b88f9b890f0207cd36b99
+  metadata.gz: c0d530b10175dffee9d5606f26ebe468a9b44f46b3a9b894ce5e702c88ec073a481ea549b8915349e5805ed057c16bf9a7be0f4d9d45a2cb6659c36e6ba67820
+  data.tar.gz: 97a0dd428a0879623922220bafe4c847f041f3512ec606a8b302a72a4a4d4905cd6418006a08915120d657a07dffbcc09a4874eba76790739f17a8739a613388

data/lib/aws-sdk-waf.rb

@@ -24,17 +24,20 @@ require_relative 'aws-sdk-waf/customizations'
 # methods each accept a hash of request parameters and return a response
 # structure.
 #
+#     waf = Aws::WAF::Client.new
+#     resp = waf.create_byte_match_set(params)
+#
 # See {Client} for more information.
 #
 # # Errors
 #
-# Errors returned from AWS WAF all
-# extend {Errors::ServiceError}.
+# Errors returned from AWS WAF are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
 #
 #     begin
 #       # do stuff
 #     rescue Aws::WAF::Errors::ServiceError
-#       # rescues all service API errors
+#       # rescues all AWS WAF API errors
 #     end
 #
 # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-waf/customizations'
 # @service
 module Aws::WAF
 
-  GEM_VERSION = '1.26.0'
+  GEM_VERSION = '1.31.1'
 
 end

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

@@ -24,12 +24,25 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:waf)
 
 module Aws::WAF
+  # An API client for WAF.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::WAF::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
+  #
+  # For details on configuring region and credentials see
+  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
+  #
+  # See {#initialize} for a full list of supported configuration options.
   class Client < Seahorse::Client::Base
 
     include Aws::ClientStubs
@@ -57,6 +70,7 @@ module Aws::WAF
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -93,7 +107,7 @@ module Aws::WAF
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -108,6 +122,12 @@ module Aws::WAF
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
     #
+    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
+    #     Used only in `adaptive` retry mode.  When true, the request will sleep
+    #     until there is sufficent client side capacity to retry the request.
+    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
+    #     not retry instead of sleeping.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -132,6 +152,10 @@ module Aws::WAF
     #     When `true`, an attempt is made to coerce request parameters into
     #     the required types.
     #
+    #   @option options [Boolean] :correct_clock_skew (true)
+    #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
+    #     a clock skew correction and retry requests with skewed client clocks.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -139,7 +163,7 @@ module Aws::WAF
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +178,7 @@ module Aws::WAF
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -166,15 +190,29 @@ module Aws::WAF
     #     The Logger instance to send log messages to.  If this option
     #     is not set, logging will be disabled.
     #
+    #   @option options [Integer] :max_attempts (3)
+    #     An integer representing the maximum number attempts that will be made for
+    #     a single request, including the initial attempt.  For example,
+    #     setting this value to 5 will result in a request being retried up to
+    #     4 times. Used in `standard` and `adaptive` retry modes.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Proc] :retry_backoff
+    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
+    #     This option is only used in the `legacy` retry mode.
+    #
     #   @option options [Float] :retry_base_delay (0.3)
-    #     The base delay in seconds used by the default backoff function.
+    #     The base delay in seconds used by the default backoff function. This option
+    #     is only used in the `legacy` retry mode.
     #
     #   @option options [Symbol] :retry_jitter (:none)
-    #     A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
+    #     A delay randomiser function used by the default backoff function.
+    #     Some predefined functions can be referenced by name - :none, :equal, :full,
+    #     otherwise a Proc that takes and returns a number. This option is only used
+    #     in the `legacy` retry mode.
     #
     #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
     #
@@ -182,11 +220,30 @@ module Aws::WAF
     #     The maximum number of times to retry failed requests.  Only
     #     ~ 500 level server errors and certain ~ 400 level client errors
     #     are retried.  Generally, these are throttling errors, data
-    #     checksum errors, networking errors, timeout errors and auth
-    #     errors from expired credentials.
+    #     checksum errors, networking errors, timeout errors, auth errors,
+    #     endpoint discovery, and errors from expired credentials.
+    #     This option is only used in the `legacy` retry mode.
     #
     #   @option options [Integer] :retry_max_delay (0)
-    #     The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
+    #     The maximum number of seconds to delay between retries (0 for no limit)
+    #     used by the default backoff function. This option is only used in the
+    #     `legacy` retry mode.
+    #
+    #   @option options [String] :retry_mode ("legacy")
+    #     Specifies which retry algorithm to use. Values are:
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -219,16 +276,15 @@ module Aws::WAF
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
     #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before rasing a
+    #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yeidled by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idble before it is
+    #     seconds a connection is allowed to sit idle before it is
     #     considered stale.  Stale connections are closed and removed
     #     from the pool before making a request.
     #
@@ -237,7 +293,7 @@ module Aws::WAF
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yeidled by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -264,6 +320,15 @@ module Aws::WAF
 
     # @!group API Operations
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `ByteMatchSet`. You then use UpdateByteMatchSet to identify
     # the part of a web request that you want AWS WAF to inspect, such as
     # the values of the `User-Agent` header or the query string. For
@@ -286,11 +351,13 @@ module Aws::WAF
     #     or the URI) and the value that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the ByteMatchSet. You can't change
@@ -332,6 +399,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates an GeoMatchSet, which you use to specify which web requests
     # you want to allow or block based on the country that the requests
     # originate from. For example, if you're receiving a lot of requests
@@ -353,11 +429,13 @@ module Aws::WAF
     #     that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the GeoMatchSet. You can't change
@@ -396,6 +474,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates an IPSet, which you use to specify which web requests that you
     # want to allow or block based on the IP addresses that the requests
     # originate from. For example, if you're receiving a lot of requests
@@ -418,11 +505,13 @@ module Aws::WAF
     #     you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the IPSet. You can't change `Name`
@@ -486,6 +575,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a RateBasedRule. The `RateBasedRule` contains a `RateLimit`,
     # which specifies the maximum number of requests that AWS WAF allows
     # from a specified IP address in a five-minute period. The
@@ -495,23 +593,23 @@ module Aws::WAF
     #
     # If you add more than one predicate to a `RateBasedRule`, a request not
     # only must exceed the `RateLimit`, but it also must match all the
-    # specifications to be counted or blocked. For example, suppose you add
-    # the following to a `RateBasedRule`\:
+    # conditions to be counted or blocked. For example, suppose you add the
+    # following to a `RateBasedRule`\:
     #
     # * An `IPSet` that matches the IP address `192.0.2.44/32`
     #
     # * A `ByteMatchSet` that matches `BadBot` in the `User-Agent` header
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # You then add the `RateBasedRule` to a `WebACL` and specify that you
     # want to block requests that meet the conditions in the rule. For a
     # request to be blocked, it must come from the IP address 192.0.2.44
     # *and* the `User-Agent` header in the request must contain the value
     # `BadBot`. Further, requests that match these two conditions must be
-    # received at a rate of more than 15,000 requests every five minutes. If
+    # received at a rate of more than 1,000 requests every five minutes. If
     # both conditions are met and the rate is exceeded, AWS WAF blocks the
-    # requests. If the rate drops below 15,000 for a five-minute period, AWS
+    # requests. If the rate drops below 1,000 for a five-minute period, AWS
     # WAF no longer blocks the requests.
     #
     # As a second example, suppose you want to limit requests to a
@@ -524,7 +622,7 @@ module Aws::WAF
     #
     # * A `TargetString` of `login`
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # By adding this `RateBasedRule` to a `WebACL`, you could limit requests
     # to your login page without affecting the rest of your site.
@@ -551,11 +649,13 @@ module Aws::WAF
     #     For more information, see CreateWebACL.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RateBasedRule. You can't change
@@ -605,8 +705,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -633,6 +733,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a RegexMatchSet. You then use UpdateRegexMatchSet to identify
     # the part of a web request that you want AWS WAF to inspect, such as
     # the values of the `User-Agent` header or the query string. For
@@ -658,11 +767,13 @@ module Aws::WAF
     #     want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RegexMatchSet. You can't change
@@ -703,6 +814,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `RegexPatternSet`. You then use UpdateRegexPatternSet to
     # specify the regular expression (regex) pattern that you want AWS WAF
     # to search for, such as `B[a@]dB[o0]t`. You can then configure AWS WAF
@@ -723,11 +843,13 @@ module Aws::WAF
     #     you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RegexPatternSet. You can't
@@ -765,6 +887,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `Rule`, which contains the `IPSet` objects, `ByteMatchSet`
     # objects, and other predicates that identify the requests that you want
     # to block. If you add more than one predicate to a `Rule`, a request
@@ -801,11 +932,13 @@ module Aws::WAF
     #     information, see CreateWebACL.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the Rule. You can't change the name
@@ -865,8 +998,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -891,6 +1024,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `RuleGroup`. A rule group is a collection of predefined
     # rules that you add to a web ACL. You use UpdateRuleGroup to add rules
     # to the rule group.
@@ -905,11 +1047,13 @@ module Aws::WAF
     # * Ten rules per rule group.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RuleGroup. You can't change
@@ -941,8 +1085,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -963,6 +1107,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `SizeConstraintSet`. You then use UpdateSizeConstraintSet to
     # identify the part of a web request that you want AWS WAF to check for
     # length, such as the length of the `User-Agent` header or the length of
@@ -988,11 +1141,13 @@ module Aws::WAF
     #     for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the SizeConstraintSet. You can't
@@ -1063,6 +1218,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a SqlInjectionMatchSet, which you use to allow, block, or
     # count requests that contain snippets of SQL code in a specified part
     # of web requests. AWS WAF searches for character sequences that are
@@ -1085,11 +1249,13 @@ module Aws::WAF
     #     malicious SQL code.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description for the SqlInjectionMatchSet that
@@ -1157,6 +1323,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `WebACL`, which contains the `Rules` that identify the
     # CloudFront web requests that you want to allow, block, or count. AWS
     # WAF evaluates `Rules` in order based on the value of `Priority` for
@@ -1189,11 +1364,13 @@ module Aws::WAF
     #     and to associate the `WebACL` with a CloudFront distribution.
     #
     # For more information about how to use the AWS WAF API, see the [AWS
-    # WAF Developer Guide][1].
+    # WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the WebACL. You can't change `Name`
@@ -1269,8 +1446,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -1301,6 +1478,82 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # Creates an AWS CloudFormation WAFV2 template for the specified web ACL
+    # in the specified Amazon S3 bucket. Then, in CloudFormation, you create
+    # a stack from the template, to create the web ACL and its resources in
+    # AWS WAFV2. Use this to migrate your AWS WAF Classic web ACL to the
+    # latest version of AWS WAF.
+    #
+    # This is part of a larger migration procedure for web ACLs from AWS WAF
+    # Classic to the latest version of AWS WAF. For the full procedure,
+    # including caveats and manual steps to complete the migration and
+    # switch over to the new web ACL, see [Migrating your AWS WAF Classic
+    # resources to AWS WAF][1] in the [AWS WAF Developer Guide][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-migrating-from-classic.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
+    # @option params [required, String] :web_acl_id
+    #   The UUID of the WAF Classic web ACL that you want to migrate to WAF
+    #   v2.
+    #
+    # @option params [required, String] :s3_bucket_name
+    #   The name of the Amazon S3 bucket to store the CloudFormation template
+    #   in. The S3 bucket must be configured as follows for the migration:
+    #
+    #   * The bucket name must start with `aws-waf-migration-`. For example,
+    #     `aws-waf-migration-my-web-acl`.
+    #
+    #   * The bucket must be in the Region where you are deploying the
+    #     template. For example, for a web ACL in us-west-2, you must use an
+    #     Amazon S3 bucket in us-west-2 and you must deploy the template stack
+    #     to us-west-2.
+    #
+    #   * The bucket policies must permit the migration process to write data.
+    #     For listings of the bucket policies, see the Examples section.
+    #
+    # @option params [required, Boolean] :ignore_unsupported_type
+    #   Indicates whether to exclude entities that can't be migrated or to
+    #   stop the migration. Set this to true to ignore unsupported entities in
+    #   the web ACL during the migration. Otherwise, if AWS WAF encounters
+    #   unsupported entities, it stops the process and throws an exception.
+    #
+    # @return [Types::CreateWebACLMigrationStackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateWebACLMigrationStackResponse#s3_object_url #s3_object_url} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_web_acl_migration_stack({
+    #     web_acl_id: "ResourceId", # required
+    #     s3_bucket_name: "S3BucketName", # required
+    #     ignore_unsupported_type: false, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.s3_object_url #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/waf-2015-08-24/CreateWebACLMigrationStack AWS API Documentation
+    #
+    # @overload create_web_acl_migration_stack(params = {})
+    # @param [Hash] params ({})
+    def create_web_acl_migration_stack(params = {}, options = {})
+      req = build_request(:create_web_acl_migration_stack, params)
+      req.send_request(options)
+    end
+
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates an XssMatchSet, which you use to allow, block, or count
     # requests that contain cross-site scripting attacks in the specified
     # part of web requests. AWS WAF searches for character sequences that
@@ -1321,11 +1574,13 @@ module Aws::WAF
     #     scripting attacks.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description for the XssMatchSet that you're
@@ -1392,6 +1647,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a ByteMatchSet. You can't delete a `ByteMatchSet`
     # if it's still used in any `Rules` or if it still includes any
     # ByteMatchTuple objects (any filters).
@@ -1409,6 +1673,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteByteMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :byte_match_set_id
     #   The `ByteMatchSetId` of the ByteMatchSet that you want to delete.
     #   `ByteMatchSetId` is returned by CreateByteMatchSet and by
@@ -1456,6 +1725,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a GeoMatchSet. You can't delete a `GeoMatchSet`
     # if it's still used in any `Rules` or if it still includes any
     # countries.
@@ -1474,6 +1752,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteGeoMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :geo_match_set_id
     #   The `GeoMatchSetID` of the GeoMatchSet that you want to delete.
     #   `GeoMatchSetId` is returned by CreateGeoMatchSet and by
@@ -1506,6 +1789,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes an IPSet. You can't delete an `IPSet` if it's
     # still used in any `Rules` or if it still includes any IP addresses.
     #
@@ -1522,6 +1814,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteIPSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :ip_set_id
     #   The `IPSetId` of the IPSet that you want to delete. `IPSetId` is
     #   returned by CreateIPSet and by ListIPSets.
@@ -1568,9 +1865,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes the LoggingConfiguration from the specified web
     # ACL.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the web ACL from which you want to
     #   delete the LoggingConfiguration.
@@ -1592,10 +1903,24 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes an IAM policy from the specified RuleGroup.
     #
     # The user making the request must be the owner of the RuleGroup.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the RuleGroup from which you want to
     #   delete the policy.
@@ -1619,6 +1944,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RateBasedRule. You can't delete a rule if it's
     # still used in any `WebACL` objects or if it still includes any
     # predicates, such as `ByteMatchSet` objects.
@@ -1636,6 +1970,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRateBasedRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the RateBasedRule that you want to delete. `RuleId` is
     #   returned by CreateRateBasedRule and by ListRateBasedRules.
@@ -1667,6 +2006,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RegexMatchSet. You can't delete a
     # `RegexMatchSet` if it's still used in any `Rules` or if it still
     # includes any `RegexMatchTuples` objects (any filters).
@@ -1684,6 +2032,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRegexMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_match_set_id
     #   The `RegexMatchSetId` of the RegexMatchSet that you want to delete.
     #   `RegexMatchSetId` is returned by CreateRegexMatchSet and by
@@ -1716,10 +2069,24 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RegexPatternSet. You can't delete a
     # `RegexPatternSet` if it's still used in any `RegexMatchSet` or if the
     # `RegexPatternSet` is not empty.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_pattern_set_id
     #   The `RegexPatternSetId` of the RegexPatternSet that you want to
     #   delete. `RegexPatternSetId` is returned by CreateRegexPatternSet and
@@ -1752,6 +2119,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a Rule. You can't delete a `Rule` if it's still
     # used in any `WebACL` objects or if it still includes any predicates,
     # such as `ByteMatchSet` objects.
@@ -1769,6 +2145,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the Rule that you want to delete. `RuleId` is returned
     #   by CreateRule and by ListRules.
@@ -1815,6 +2196,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RuleGroup. You can't delete a `RuleGroup` if
     # it's still used in any `WebACL` objects or if it still includes any
     # rules.
@@ -1833,6 +2223,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRuleGroup` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup that you want to delete.
     #   `RuleGroupId` is returned by CreateRuleGroup and by ListRuleGroups.
@@ -1864,6 +2259,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a SizeConstraintSet. You can't delete a
     # `SizeConstraintSet` if it's still used in any `Rules` or if it still
     # includes any SizeConstraint objects (any filters).
@@ -1882,6 +2286,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteSizeConstraintSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :size_constraint_set_id
     #   The `SizeConstraintSetId` of the SizeConstraintSet that you want to
     #   delete. `SizeConstraintSetId` is returned by CreateSizeConstraintSet
@@ -1929,6 +2338,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a SqlInjectionMatchSet. You can't delete a
     # `SqlInjectionMatchSet` if it's still used in any `Rules` or if it
     # still contains any SqlInjectionMatchTuple objects.
@@ -1947,6 +2365,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteSqlInjectionMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :sql_injection_match_set_id
     #   The `SqlInjectionMatchSetId` of the SqlInjectionMatchSet that you want
     #   to delete. `SqlInjectionMatchSetId` is returned by
@@ -1994,6 +2417,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a WebACL. You can't delete a `WebACL` if it still
     # contains any `Rules`.
     #
@@ -2007,6 +2439,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteWebACL` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the WebACL that you want to delete. `WebACLId` is
     #   returned by CreateWebACL and by ListWebACLs.
@@ -2053,6 +2490,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes an XssMatchSet. You can't delete an `XssMatchSet`
     # if it's still used in any `Rules` or if it still contains any
     # XssMatchTuple objects.
@@ -2071,6 +2517,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteXssMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :xss_match_set_id
     #   The `XssMatchSetId` of the XssMatchSet that you want to delete.
     #   `XssMatchSetId` is returned by CreateXssMatchSet and by
@@ -2118,8 +2569,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the ByteMatchSet specified by `ByteMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :byte_match_set_id
     #   The `ByteMatchSetId` of the ByteMatchSet that you want to get.
     #   `ByteMatchSetId` is returned by CreateByteMatchSet and by
@@ -2183,6 +2648,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # When you want to create, update, or delete AWS WAF objects, get a
     # change token and include the change token in the create, update, or
     # delete request. Change tokens ensure that your application doesn't
@@ -2199,6 +2673,11 @@ module Aws::WAF
     # that AWS WAF is propagating the change to all AWS WAF servers. Use
     # `GetChangeTokenStatus` to determine the status of your change token.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @return [Types::GetChangeTokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetChangeTokenResponse#change_token #change_token} => String
@@ -2229,6 +2708,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the status of a `ChangeToken` that you got by calling
     # GetChangeToken. `ChangeTokenStatus` is one of the following values:
     #
@@ -2241,6 +2729,11 @@ module Aws::WAF
     #
     # * `INSYNC`\: Propagation is complete.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :change_token
     #   The change token for which you want to get the status. This change
     #   token was previously returned in the `GetChangeToken` response.
@@ -2282,8 +2775,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the GeoMatchSet that is specified by `GeoMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :geo_match_set_id
     #   The `GeoMatchSetId` of the GeoMatchSet that you want to get.
     #   `GeoMatchSetId` is returned by CreateGeoMatchSet and by
@@ -2316,8 +2823,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the IPSet that is specified by `IPSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :ip_set_id
     #   The `IPSetId` of the IPSet that you want to get. `IPSetId` is returned
     #   by CreateIPSet and by ListIPSets.
@@ -2372,8 +2893,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the LoggingConfiguration for the specified web ACL.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the web ACL for which you want to
     #   get the LoggingConfiguration.
@@ -2406,8 +2941,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the IAM policy attached to the RuleGroup.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the RuleGroup for which you want to
     #   get the policy.
@@ -2435,9 +2984,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RateBasedRule that is specified by the `RuleId` that you
     # included in the `GetRateBasedRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the RateBasedRule that you want to get. `RuleId` is
     #   returned by CreateRateBasedRule and by ListRateBasedRules.
@@ -2473,12 +3036,26 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of IP addresses currently being blocked by the
     # RateBasedRule that is specified by the `RuleId`. The maximum number of
     # managed keys that will be blocked is 10,000. If more than 10,000
     # addresses exceed the rate limit, the 10,000 addresses with the highest
     # rates will be blocked.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the RateBasedRule for which you want to get a list of
     #   `ManagedKeys`. `RuleId` is returned by CreateRateBasedRule and by
@@ -2515,8 +3092,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RegexMatchSet specified by `RegexMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_match_set_id
     #   The `RegexMatchSetId` of the RegexMatchSet that you want to get.
     #   `RegexMatchSetId` is returned by CreateRegexMatchSet and by
@@ -2551,8 +3142,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RegexPatternSet specified by `RegexPatternSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_pattern_set_id
     #   The `RegexPatternSetId` of the RegexPatternSet that you want to get.
     #   `RegexPatternSetId` is returned by CreateRegexPatternSet and by
@@ -2584,9 +3189,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the Rule that is specified by the `RuleId` that you included
     # in the `GetRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the Rule that you want to get. `RuleId` is returned by
     #   CreateRule and by ListRules.
@@ -2645,11 +3264,25 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RuleGroup that is specified by the `RuleGroupId` that you
     # included in the `GetRuleGroup` request.
     #
     # To view the rules in a rule group, use ListActivatedRulesInRuleGroup.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup that you want to get. `RuleGroupId`
     #   is returned by CreateRuleGroup and by ListRuleGroups.
@@ -2679,6 +3312,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Gets detailed information about a specified number of requests--a
     # sample--that AWS WAF randomly selects from among the first 5,000
     # requests that your AWS resource received during a time range that you
@@ -2692,6 +3334,11 @@ module Aws::WAF
     # range. This new time range indicates the actual period during which
     # AWS WAF selected the requests in the sample.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the `WebACL` for which you want `GetSampledRequests`
     #   to return a sample of requests.
@@ -2710,7 +3357,8 @@ module Aws::WAF
     # @option params [required, Types::TimeWindow] :time_window
     #   The start date and time and the end date and time of the range for
     #   which you want `GetSampledRequests` to return a sample of requests.
-    #   Specify the date and time in the following format:
+    #   You must specify the times in Coordinated Universal Time (UTC) format.
+    #   UTC format includes the special designator, `Z`. For example,
     #   `"2016-09-27T14:50Z"`. You can specify any time range in the previous
     #   three hours.
     #
@@ -2812,8 +3460,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the SizeConstraintSet specified by `SizeConstraintSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :size_constraint_set_id
     #   The `SizeConstraintSetId` of the SizeConstraintSet that you want to
     #   get. `SizeConstraintSetId` is returned by CreateSizeConstraintSet and
@@ -2877,9 +3539,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the SqlInjectionMatchSet that is specified by
     # `SqlInjectionMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :sql_injection_match_set_id
     #   The `SqlInjectionMatchSetId` of the SqlInjectionMatchSet that you want
     #   to get. `SqlInjectionMatchSetId` is returned by
@@ -2939,8 +3615,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the WebACL that is specified by `WebACLId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the WebACL that you want to get. `WebACLId` is
     #   returned by CreateWebACL and by ListWebACLs.
@@ -3010,8 +3700,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the XssMatchSet that is specified by `XssMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :xss_match_set_id
     #   The `XssMatchSetId` of the XssMatchSet that you want to get.
     #   `XssMatchSetId` is returned by CreateXssMatchSet and by
@@ -3070,8 +3774,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of ActivatedRule objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup for which you want to get a list of
     #   ActivatedRule objects.
@@ -3125,8 +3843,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of ByteMatchSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `ByteMatchSets`
     #   than the value of `Limit`, AWS WAF returns a `NextMarker` value in the
@@ -3170,8 +3902,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of GeoMatchSetSummary objects in the response.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `GeoMatchSet`s
     #   than the value of `Limit`, AWS WAF returns a `NextMarker` value in the
@@ -3215,8 +3961,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of IPSetSummary objects in the response.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   AWS WAF returns a `NextMarker` value in the response that allows you
     #   to list another group of `IPSets`. For the second and subsequent
@@ -3276,8 +4036,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of LoggingConfiguration objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   `LoggingConfigurations` than the value of `Limit`, AWS WAF returns a
@@ -3326,8 +4100,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `Rules` than the
     #   value of `Limit`, AWS WAF returns a `NextMarker` value in the response
@@ -3370,8 +4158,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RegexMatchSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `RegexMatchSet`
     #   objects than the value of `Limit`, AWS WAF returns a `NextMarker`
@@ -3415,8 +4217,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RegexPatternSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `RegexPatternSet`
     #   objects than the value of `Limit`, AWS WAF returns a `NextMarker`
@@ -3461,8 +4277,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleGroup objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `RuleGroups` than
     #   the value of `Limit`, AWS WAF returns a `NextMarker` value in the
@@ -3505,8 +4335,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `Rules` than the
     #   value of `Limit`, AWS WAF returns a `NextMarker` value in the response
@@ -3568,8 +4412,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of SizeConstraintSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   `SizeConstraintSets` than the value of `Limit`, AWS WAF returns a
@@ -3633,8 +4491,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of SqlInjectionMatchSet objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   SqlInjectionMatchSet objects than the value of `Limit`, AWS WAF
@@ -3698,8 +4570,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleGroup objects that you are subscribed to.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   `ByteMatchSets`subscribed rule groups than the value of `Limit`, AWS
@@ -3744,6 +4630,32 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    # Retrieves the tags associated with the specified AWS resource. Tags
+    # are key:value pairs that you can use to categorize and manage your
+    # resources, for purposes like billing. For example, you might set the
+    # tag key to "customer" and the value to the customer name or ID. You
+    # can specify one or more tags to add to each AWS resource, up to 50
+    # tags for a resource.
+    #
+    # Tagging is only available through the API, SDKs, and CLI. You can't
+    # manage or view tags through the AWS WAF Classic console. You can tag
+    # the AWS resources that you manage through AWS WAF Classic: web ACLs,
+    # rule groups, and rules.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #
     # @option params [Integer] :limit
@@ -3780,8 +4692,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of WebACLSummary objects in the response.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `WebACL` objects
     #   than the number that you specify for `Limit`, AWS WAF returns a
@@ -3844,8 +4770,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of XssMatchSet objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more XssMatchSet
     #   objects than the value of `Limit`, AWS WAF returns a `NextMarker`
@@ -3907,6 +4847,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Associates a LoggingConfiguration with a specified web ACL.
     #
     # You can access information about all traffic that AWS WAF inspects
@@ -3929,12 +4878,14 @@ module Aws::WAF
     # When you successfully enable logging using a `PutLoggingConfiguration`
     # request, AWS WAF will create a service linked role with the necessary
     # permissions to write logs to the Amazon Kinesis Data Firehose. For
-    # more information, see [Logging Web ACL Traffic Information][1] in the
+    # more information, see [Logging Web ACL Traffic Information][3] in the
     # *AWS WAF Developer Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/logging.html
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/logging.html
     #
     # @option params [required, Types::LoggingConfiguration] :logging_configuration
     #   The Amazon Kinesis Data Firehose that contains the inspected traffic
@@ -3983,7 +4934,16 @@ module Aws::WAF
       req.send_request(options)
     end
 
-    # Attaches a IAM policy to the specified resource. The only supported
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    # Attaches an IAM policy to the specified resource. The only supported
     # use for this action is to share a RuleGroup across accounts.
     #
     # The `PutPermissionPolicy` is subject to the following restrictions:
@@ -4009,14 +4969,16 @@ module Aws::WAF
     #
     # * Your policy must be composed using IAM Policy version 2012-10-17.
     #
-    # For more information, see [IAM Policies][1].
+    # For more information, see [IAM Policies][3].
     #
     # An example of a valid policy parameter is shown in the Examples
     # section below.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the RuleGroup to which you want to
@@ -4043,6 +5005,32 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    # Associates tags with the specified AWS resource. Tags are key:value
+    # pairs that you can use to categorize and manage your resources, for
+    # purposes like billing. For example, you might set the tag key to
+    # "customer" and the value to the customer name or ID. You can specify
+    # one or more tags to add to each AWS resource, up to 50 tags for a
+    # resource.
+    #
+    # Tagging is only available through the API, SDKs, and CLI. You can't
+    # manage or view tags through the AWS WAF Classic console. You can use
+    # this action to tag the AWS resources that you manage through AWS WAF
+    # Classic: web ACLs, rule groups, and rules.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #
     # @option params [required, Array<Types::Tag>] :tags
@@ -4055,8 +5043,8 @@ module Aws::WAF
     #     resource_arn: "ResourceArn", # required
     #     tags: [ # required
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -4070,6 +5058,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    #
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #
     # @option params [required, Array<String>] :tag_keys
@@ -4092,6 +5096,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet.
     # For each `ByteMatchTuple` object, you specify the following values:
     #
@@ -4131,11 +5144,13 @@ module Aws::WAF
     #     or the URI) and the value that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :byte_match_set_id
     #   The `ByteMatchSetId` of the ByteMatchSet that you want to update.
@@ -4225,6 +5240,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes GeoMatchConstraint objects in an `GeoMatchSet`. For
     # each `GeoMatchConstraint` object, you specify the following values:
     #
@@ -4253,11 +5277,13 @@ module Aws::WAF
     # change a country, you delete the existing country and add the new one.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :geo_match_set_id
     #   The `GeoMatchSetId` of the GeoMatchSet that you want to update.
@@ -4313,6 +5339,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes IPSetDescriptor objects in an `IPSet`. For each
     # `IPSetDescriptor` object, you specify the following values:
     #
@@ -4329,7 +5364,7 @@ module Aws::WAF
     # AWS WAF supports IPv4 address ranges: /8 and any range between /16
     # through /32. AWS WAF supports IPv6 address ranges: /24, /32, /48, /56,
     # /64, and /128. For more information about CIDR notation, see the
-    # Wikipedia entry [Classless Inter-Domain Routing][1].
+    # Wikipedia entry [Classless Inter-Domain Routing][3].
     #
     # IPv6 addresses can be represented using any of the following formats:
     #
@@ -4366,12 +5401,14 @@ module Aws::WAF
     # You can insert a maximum of 1000 addresses in a single request.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][2].
+    # block HTTP requests, see the [AWS WAF Developer Guide][4].
     #
     #
     #
-    # [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
-    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
+    # [4]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :ip_set_id
     #   The `IPSetId` of the IPSet that you want to update. `IPSetId` is
@@ -4449,6 +5486,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes Predicate objects in a rule and updates the
     # `RateLimit` in the rule.
     #
@@ -4466,14 +5512,14 @@ module Aws::WAF
     #
     # * A `ByteMatchSet` that matches `BadBot` in the `User-Agent` header
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # You then add the `RateBasedRule` to a `WebACL` and specify that you
     # want to block requests that satisfy the rule. For a request to be
     # blocked, it must come from the IP address 192.0.2.44 *and* the
     # `User-Agent` header in the request must contain the value `BadBot`.
     # Further, requests that match these two conditions much be received at
-    # a rate of more than 15,000 every five minutes. If the rate drops below
+    # a rate of more than 1,000 every five minutes. If the rate drops below
     # this limit, AWS WAF no longer blocks the requests.
     #
     # As a second example, suppose you want to limit requests to a
@@ -4486,11 +5532,16 @@ module Aws::WAF
     #
     # * A `TargetString` of `login`
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # By adding this `RateBasedRule` to a `WebACL`, you could limit requests
     # to your login page without affecting the rest of your site.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the `RateBasedRule` that you want to update. `RuleId`
     #   is returned by `CreateRateBasedRule` and by ListRateBasedRules.
@@ -4544,6 +5595,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes RegexMatchTuple objects (filters) in a
     # RegexMatchSet. For each `RegexMatchSetUpdate` object, you specify the
     # following values:
@@ -4583,11 +5643,13 @@ module Aws::WAF
     #     for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :regex_match_set_id
     #   The `RegexMatchSetId` of the RegexMatchSet that you want to update.
@@ -4639,6 +5701,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes `RegexPatternString` objects in a RegexPatternSet.
     # For each `RegexPatternString` object, you specify the following
     # values:
@@ -4672,11 +5743,13 @@ module Aws::WAF
     #     expression pattern that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :regex_pattern_set_id
     #   The `RegexPatternSetId` of the RegexPatternSet that you want to
@@ -4720,6 +5793,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes Predicate objects in a `Rule`. Each `Predicate`
     # object identifies a predicate, such as a ByteMatchSet or an IPSet,
     # that specifies the web requests that you want to allow, block, or
@@ -4756,11 +5838,13 @@ module Aws::WAF
     # delete the existing one and add the new one.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the `Rule` that you want to update. `RuleId` is
@@ -4839,6 +5923,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes ActivatedRule objects in a `RuleGroup`.
     #
     # You can only insert `REGULAR` rules into a rule group.
@@ -4863,11 +5956,13 @@ module Aws::WAF
     # existing one and add the new one.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup that you want to update.
@@ -4933,6 +6028,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes SizeConstraint objects (filters) in a
     # SizeConstraintSet. For each `SizeConstraint` object, you specify the
     # following values:
@@ -4981,11 +6085,13 @@ module Aws::WAF
     #     for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :size_constraint_set_id
     #   The `SizeConstraintSetId` of the SizeConstraintSet that you want to
@@ -5074,6 +6180,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes SqlInjectionMatchTuple objects (filters) in a
     # SqlInjectionMatchSet. For each `SqlInjectionMatchTuple` object, you
     # specify the following values:
@@ -5112,11 +6227,13 @@ module Aws::WAF
     #     snippets of SQL code.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :sql_injection_match_set_id
     #   The `SqlInjectionMatchSetId` of the `SqlInjectionMatchSet` that you
@@ -5202,6 +6319,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes ActivatedRule objects in a `WebACL`. Each `Rule`
     # identifies web requests that you want to allow, block, or count. When
     # you update a `WebACL`, you specify the following values:
@@ -5247,14 +6373,14 @@ module Aws::WAF
     #     and to associate the `WebACL` with a CloudFront distribution.
     #
     #     The `ActivatedRule` can be a rule group. If you specify a rule
-    #     group as your `ActivatedRule`, you can exclude specific rules from
-    #     that rule group.
+    #     group as your `ActivatedRule` , you can exclude specific rules
+    #     from that rule group.
     #
     #     If you already have a rule group associated with a web ACL and
     #     want to submit an `UpdateWebACL` request to exclude certain rules
     #     from that rule group, you must first remove the rule group from
     #     the web ACL, the re-insert it again, specifying the excluded
-    #     rules. For details, see ActivatedRule$ExcludedRules.
+    #     rules. For details, see ActivatedRule$ExcludedRules .
     #
     # Be aware that if you try to add a RATE\_BASED rule to a web ACL
     # without setting the rule type when first creating the rule, the
@@ -5263,11 +6389,13 @@ module Aws::WAF
     # not exist.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the WebACL that you want to update. `WebACLId` is
@@ -5377,6 +6505,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet.
     # For each `XssMatchTuple` object, you specify the following values:
     #
@@ -5413,11 +6550,13 @@ module Aws::WAF
     #     attacks.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :xss_match_set_id
     #   The `XssMatchSetId` of the `XssMatchSet` that you want to update.
@@ -5514,7 +6653,7 @@ module Aws::WAF
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-waf'
-      context[:gem_version] = '1.26.0'
+      context[:gem_version] = '1.31.1'
       Seahorse::Client::Request.new(handlers, context)
     end