RubyGems - aws-sdk-waf - Versions diffs - 1.26.0 → 1.31.1 - Mend

aws-sdk-waf 1.26.0 → 1.31.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

checksums.yaml +5 -5
data/lib/aws-sdk-waf.rb +7 -4
data/lib/aws-sdk-waf/client.rb +1229 -90
data/lib/aws-sdk-waf/client_api.rb +38 -2
data/lib/aws-sdk-waf/errors.rb +74 -15
data/lib/aws-sdk-waf/resource.rb +1 -0
data/lib/aws-sdk-waf/types.rb +935 -30
metadata +5 -5

checksums.yaml CHANGED

@@ -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 CHANGED

@@ -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 CHANGED

@@ -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