aws-sdk-wafregional 1.27.0 → 1.32.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 34658ed46e45dd86458d84c65927e38b321c2cd6
-  data.tar.gz: f7f54132fd5cdc4e7c03ce79ab173e90393cca30
+SHA256:
+  metadata.gz: edde10899dce9082969f664864893f101f5e3ccf2ae6cbaee928e3fcb29ad9c7
+  data.tar.gz: 1901676129d4ecc4beb9ea464e96e2ec3139e6a323e9b112499146b157463856
 SHA512:
-  metadata.gz: 22d1328db5216455ffba3af86cc0fe49ddaea02dac2e391b8da349ddf50fb2b7f3e6f9efe9def100ac185a8d5802622bd628d129321baae55fab9a2b65df0b3b
-  data.tar.gz: 614591be5df14f7d86b4536e22f34298812d8a2d33fc83f13313ae94fcc63c9b61c20b15f2a8c054e3e2777dc0be505a590428db9d6eff21f570182fcf07603f
+  metadata.gz: 2c8ddf2d7ddcd9e6bfdf83bce6c8b58c906bb36171fc2ae936db78e3d4b49fb78f363735c47a9298fcaf0bdf6cf19dfdefebd2566d70578d1c46f5c3b454a6f3
+  data.tar.gz: f982c8f5f7e020ea538887aa543842de0aa462392870634f73994b5c740b8c18ce687e019ea5c3b4ca0ac063a89ef3b1a82ce237221d2c89fbb295f87a40a18b

data/lib/aws-sdk-wafregional.rb

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

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

@@ -24,12 +24,25 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:wafregional)
 
 module Aws::WAFRegional
+  # An API client for WAFRegional.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::WAFRegional::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::WAFRegional
     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::WAFRegional
     #   @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::WAFRegional
     #     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::WAFRegional
     #     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::WAFRegional
     #   @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::WAFRegional
     #     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::WAFRegional
     #     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::WAFRegional
     #     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::WAFRegional
     #     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::WAFRegional
     #     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,9 +320,23 @@ module Aws::WAFRegional
 
     # @!group API Operations
 
+    # <note markdown="1"> This is **AWS WAF Classic Regional** 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 web ACL with a resource, either an application load
     # balancer or Amazon API Gateway stage.
     #
+    #
+    #
+    # [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
     #   A unique identifier (ID) for the web ACL.
     #
@@ -301,6 +371,15 @@ module Aws::WAFRegional
       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 `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
@@ -323,11 +402,13 @@ module Aws::WAFRegional
     #     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
@@ -369,6 +450,15 @@ module Aws::WAFRegional
       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
@@ -390,11 +480,13 @@ module Aws::WAFRegional
     #     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
@@ -433,6 +525,15 @@ module Aws::WAFRegional
       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
@@ -455,11 +556,13 @@ module Aws::WAFRegional
     #     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`
@@ -523,6 +626,15 @@ module Aws::WAFRegional
       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
@@ -532,23 +644,23 @@ module Aws::WAFRegional
     #
     # 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
@@ -561,7 +673,7 @@ module Aws::WAFRegional
     #
     # * 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.
@@ -588,11 +700,13 @@ module Aws::WAFRegional
     #     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
@@ -642,8 +756,8 @@ module Aws::WAFRegional
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -670,6 +784,15 @@ module Aws::WAFRegional
       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
@@ -695,11 +818,13 @@ module Aws::WAFRegional
     #     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
@@ -740,6 +865,15 @@ module Aws::WAFRegional
       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
@@ -760,11 +894,13 @@ module Aws::WAFRegional
     #     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
@@ -802,6 +938,15 @@ module Aws::WAFRegional
       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
@@ -838,11 +983,13 @@ module Aws::WAFRegional
     #     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
@@ -902,8 +1049,8 @@ module Aws::WAFRegional
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -928,6 +1075,15 @@ module Aws::WAFRegional
       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.
@@ -942,11 +1098,13 @@ module Aws::WAFRegional
     # * 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
@@ -978,8 +1136,8 @@ module Aws::WAFRegional
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -1000,6 +1158,15 @@ module Aws::WAFRegional
       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
@@ -1025,11 +1192,13 @@ module Aws::WAFRegional
     #     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
@@ -1100,6 +1269,15 @@ module Aws::WAFRegional
       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
@@ -1122,11 +1300,13 @@ module Aws::WAFRegional
     #     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
@@ -1194,6 +1374,15 @@ module Aws::WAFRegional
       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
@@ -1226,11 +1415,13 @@ module Aws::WAFRegional
     #     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`
@@ -1306,8 +1497,8 @@ module Aws::WAFRegional
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -1338,6 +1529,82 @@ module Aws::WAFRegional
       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-regional-2016-11-28/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
@@ -1358,11 +1625,13 @@ module Aws::WAFRegional
     #     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
@@ -1429,6 +1698,15 @@ module Aws::WAFRegional
       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).
@@ -1446,6 +1724,11 @@ module Aws::WAFRegional
     #
     # 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
@@ -1493,6 +1776,15 @@ module Aws::WAFRegional
       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.
@@ -1511,6 +1803,11 @@ module Aws::WAFRegional
     #
     # 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
@@ -1543,6 +1840,15 @@ module Aws::WAFRegional
       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.
     #
@@ -1559,6 +1865,11 @@ module Aws::WAFRegional
     #
     # 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.
@@ -1605,9 +1916,23 @@ module Aws::WAFRegional
       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.
@@ -1629,10 +1954,24 @@ module Aws::WAFRegional
       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.
@@ -1656,6 +1995,15 @@ module Aws::WAFRegional
       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.
@@ -1673,6 +2021,11 @@ module Aws::WAFRegional
     #
     # 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.
@@ -1704,6 +2057,15 @@ module Aws::WAFRegional
       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).
@@ -1721,6 +2083,11 @@ module Aws::WAFRegional
     #
     # 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
@@ -1753,10 +2120,24 @@ module Aws::WAFRegional
       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
@@ -1789,6 +2170,15 @@ module Aws::WAFRegional
       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.
@@ -1806,6 +2196,11 @@ module Aws::WAFRegional
     #
     # 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.
@@ -1852,6 +2247,15 @@ module Aws::WAFRegional
       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.
@@ -1870,6 +2274,11 @@ module Aws::WAFRegional
     #
     # 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.
@@ -1901,6 +2310,15 @@ module Aws::WAFRegional
       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).
@@ -1919,6 +2337,11 @@ module Aws::WAFRegional
     #
     # 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
@@ -1966,6 +2389,15 @@ module Aws::WAFRegional
       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.
@@ -1984,6 +2416,11 @@ module Aws::WAFRegional
     #
     # 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
@@ -2031,6 +2468,15 @@ module Aws::WAFRegional
       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`.
     #
@@ -2044,6 +2490,11 @@ module Aws::WAFRegional
     #
     # 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.
@@ -2090,6 +2541,15 @@ module Aws::WAFRegional
       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.
@@ -2108,6 +2568,11 @@ module Aws::WAFRegional
     #
     # 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
@@ -2155,9 +2620,23 @@ module Aws::WAFRegional
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic Regional** 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>
+    #
     # Removes a web ACL from the specified resource, either an application
     # load balancer or Amazon API Gateway stage.
     #
+    #
+    #
+    # [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 ARN (Amazon Resource Name) of the resource from which the web ACL
     #   is being removed, either an application load balancer or Amazon API
@@ -2189,8 +2668,22 @@ module Aws::WAFRegional
       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
@@ -2254,6 +2747,15 @@ module Aws::WAFRegional
       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
@@ -2270,6 +2772,11 @@ module Aws::WAFRegional
     # 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
@@ -2300,6 +2807,15 @@ module Aws::WAFRegional
       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:
     #
@@ -2312,6 +2828,11 @@ module Aws::WAFRegional
     #
     # * `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.
@@ -2353,8 +2874,22 @@ module Aws::WAFRegional
       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
@@ -2387,8 +2922,22 @@ module Aws::WAFRegional
       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.
@@ -2443,8 +2992,22 @@ module Aws::WAFRegional
       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.
@@ -2477,8 +3040,22 @@ module Aws::WAFRegional
       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.
@@ -2506,9 +3083,23 @@ module Aws::WAFRegional
       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.
@@ -2544,12 +3135,26 @@ module Aws::WAFRegional
       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
@@ -2586,8 +3191,22 @@ module Aws::WAFRegional
       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
@@ -2622,8 +3241,22 @@ module Aws::WAFRegional
       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
@@ -2655,9 +3288,23 @@ module Aws::WAFRegional
       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.
@@ -2716,11 +3363,25 @@ module Aws::WAFRegional
       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.
@@ -2750,6 +3411,15 @@ module Aws::WAFRegional
       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
@@ -2763,6 +3433,11 @@ module Aws::WAFRegional
     # 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.
@@ -2781,7 +3456,8 @@ module Aws::WAFRegional
     # @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.
     #
@@ -2883,8 +3559,22 @@ module Aws::WAFRegional
       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
@@ -2948,9 +3638,23 @@ module Aws::WAFRegional
       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
@@ -3010,8 +3714,22 @@ module Aws::WAFRegional
       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.
@@ -3081,9 +3799,23 @@ module Aws::WAFRegional
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic Regional** 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 web ACL for the specified resource, either an application
     # load balancer or Amazon API Gateway stage.
     #
+    #
+    #
+    # [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 ARN (Amazon Resource Name) of the resource for which to get the
     #   web ACL, either an application load balancer or Amazon API Gateway
@@ -3122,8 +3854,22 @@ module Aws::WAFRegional
       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
@@ -3182,8 +3928,22 @@ module Aws::WAFRegional
       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.
@@ -3237,8 +3997,22 @@ module Aws::WAFRegional
       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
@@ -3282,8 +4056,22 @@ module Aws::WAFRegional
       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
@@ -3327,8 +4115,22 @@ module Aws::WAFRegional
       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
@@ -3388,8 +4190,22 @@ module Aws::WAFRegional
       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
@@ -3438,8 +4254,22 @@ module Aws::WAFRegional
       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
@@ -3482,8 +4312,22 @@ module Aws::WAFRegional
       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`
@@ -3527,8 +4371,22 @@ module Aws::WAFRegional
       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`
@@ -3573,8 +4431,22 @@ module Aws::WAFRegional
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic Regional** 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 resources associated with 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] :web_acl_id
     #   The unique identifier (ID) of the web ACL for which to list the
     #   associated resources.
@@ -3608,8 +4480,22 @@ module Aws::WAFRegional
       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
@@ -3652,8 +4538,22 @@ module Aws::WAFRegional
       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
@@ -3715,8 +4615,22 @@ module Aws::WAFRegional
       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
@@ -3780,8 +4694,22 @@ module Aws::WAFRegional
       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
@@ -3845,8 +4773,22 @@ module Aws::WAFRegional
       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
@@ -3891,6 +4833,32 @@ module Aws::WAFRegional
       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
@@ -3927,8 +4895,22 @@ module Aws::WAFRegional
       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
@@ -3991,8 +4973,22 @@ module Aws::WAFRegional
       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`
@@ -4054,6 +5050,15 @@ module Aws::WAFRegional
       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
@@ -4076,12 +5081,14 @@ module Aws::WAFRegional
     # 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
@@ -4130,7 +5137,16 @@ module Aws::WAFRegional
       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:
@@ -4156,14 +5172,16 @@ module Aws::WAFRegional
     #
     # * 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
@@ -4190,6 +5208,32 @@ module Aws::WAFRegional
       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
@@ -4202,8 +5246,8 @@ module Aws::WAFRegional
     #     resource_arn: "ResourceArn", # required
     #     tags: [ # required
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -4217,6 +5261,22 @@ module Aws::WAFRegional
       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
@@ -4239,6 +5299,15 @@ module Aws::WAFRegional
       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:
     #
@@ -4278,11 +5347,13 @@ module Aws::WAFRegional
     #     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.
@@ -4372,6 +5443,15 @@ module Aws::WAFRegional
       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:
     #
@@ -4400,11 +5480,13 @@ module Aws::WAFRegional
     # 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.
@@ -4460,6 +5542,15 @@ module Aws::WAFRegional
       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:
     #
@@ -4476,7 +5567,7 @@ module Aws::WAFRegional
     # 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:
     #
@@ -4513,12 +5604,14 @@ module Aws::WAFRegional
     # 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
@@ -4596,6 +5689,15 @@ module Aws::WAFRegional
       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.
     #
@@ -4613,14 +5715,14 @@ module Aws::WAFRegional
     #
     # * 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
@@ -4633,11 +5735,16 @@ module Aws::WAFRegional
     #
     # * 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.
@@ -4691,6 +5798,15 @@ module Aws::WAFRegional
       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:
@@ -4730,11 +5846,13 @@ module Aws::WAFRegional
     #     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.
@@ -4786,6 +5904,15 @@ module Aws::WAFRegional
       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:
@@ -4819,11 +5946,13 @@ module Aws::WAFRegional
     #     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
@@ -4867,6 +5996,15 @@ module Aws::WAFRegional
       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
@@ -4903,11 +6041,13 @@ module Aws::WAFRegional
     # 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
@@ -4986,6 +6126,15 @@ module Aws::WAFRegional
       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.
@@ -5010,11 +6159,13 @@ module Aws::WAFRegional
     # 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.
@@ -5080,6 +6231,15 @@ module Aws::WAFRegional
       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:
@@ -5128,11 +6288,13 @@ module Aws::WAFRegional
     #     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
@@ -5221,6 +6383,15 @@ module Aws::WAFRegional
       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:
@@ -5259,11 +6430,13 @@ module Aws::WAFRegional
     #     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
@@ -5349,6 +6522,15 @@ module Aws::WAFRegional
       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:
@@ -5394,14 +6576,14 @@ module Aws::WAFRegional
     #     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
@@ -5410,11 +6592,13 @@ module Aws::WAFRegional
     # 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
@@ -5524,6 +6708,15 @@ module Aws::WAFRegional
       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:
     #
@@ -5560,11 +6753,13 @@ module Aws::WAFRegional
     #     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.
@@ -5661,7 +6856,7 @@ module Aws::WAFRegional
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-wafregional'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.32.1'
       Seahorse::Client::Request.new(handlers, context)
     end