aws-sdk-waf 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5d53a5f05712f0898112a5db24ec2b0625032168
-  data.tar.gz: 0e1d156014f78a6e70175a4183881c30738a4f49
+SHA256:
+  metadata.gz: 8f4fbc57efdf74652290f8250d3b9badb0f3c79d232c8895426f7d9944ffa517
+  data.tar.gz: 90f5cf416af1f2d6048c70cfad7c61f20d1673088d6668898a155cac237b08ab
 SHA512:
-  metadata.gz: d9811df31107086bf97c89928ba50cac0cdc31898cf24bc077d3943dfd49cd89d7077737f674ebb283d5db865aa20c5b3464fd636f5391f86d0c56e27b1c1917
-  data.tar.gz: 661b3dc670ab6ddf8e5f0861632598a733cf7a9aabb0e7844647c828f0f6e55b32be48b9bb6a4a6f11ac98c120a3883cb63ac46a727135984bcf235e460545f9
+  metadata.gz: 20086a4ddd036461a7de82095966ae6c1e100b1fd03888b56f5af9954d02cc7c79480f3e59a7bcd17de37be3be40ec007678198cee37f83c1bd87cb624bf8805
+  data.tar.gz: 1f85354c117c9ebaff7bb9fea819f6fcb9041984588e3d3d38345f637a76210b629416ad2c73b6b4a9d207d3d84f539168f82987b68911f819b6d6bf2c5d76e6

data/lib/aws-sdk-waf.rb

@@ -45,6 +45,6 @@ require_relative 'aws-sdk-waf/customizations'
 # @service
 module Aws::WAF
 
-  GEM_VERSION = '1.27.0'
+  GEM_VERSION = '1.28.0'
 
 end

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

@@ -32,11 +32,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:waf)
 module Aws::WAF
   # An API client for WAF.  To construct a client, you need to configure a `:region` and `:credentials`.
   #
-  #   client = Aws::WAF::Client.new(
-  #     region: region_name,
-  #     credentials: credentials,
-  #     # ...
-  #   )
+  #     client = Aws::WAF::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
   #
   # For details on configuring region and credentials see
   # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -229,15 +229,19 @@ module Aws::WAF
     #
     #   @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.
+    #
+    #     * `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
     #
@@ -275,8 +279,7 @@ module Aws::WAF
     #
     #   @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 yielded 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 idle before it is
@@ -288,7 +291,7 @@ module Aws::WAF
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded 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`.
@@ -315,6 +318,15 @@ module Aws::WAF
 
     # @!group API Operations
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `ByteMatchSet`. You then use UpdateByteMatchSet to identify
     # the part of a web request that you want AWS WAF to inspect, such as
     # the values of the `User-Agent` header or the query string. For
@@ -337,11 +349,13 @@ module Aws::WAF
     #     or the URI) and the value that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the ByteMatchSet. You can't change
@@ -383,6 +397,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates an GeoMatchSet, which you use to specify which web requests
     # you want to allow or block based on the country that the requests
     # originate from. For example, if you're receiving a lot of requests
@@ -404,11 +427,13 @@ module Aws::WAF
     #     that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the GeoMatchSet. You can't change
@@ -447,6 +472,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates an IPSet, which you use to specify which web requests that you
     # want to allow or block based on the IP addresses that the requests
     # originate from. For example, if you're receiving a lot of requests
@@ -469,11 +503,13 @@ module Aws::WAF
     #     you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the IPSet. You can't change `Name`
@@ -537,6 +573,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a RateBasedRule. The `RateBasedRule` contains a `RateLimit`,
     # which specifies the maximum number of requests that AWS WAF allows
     # from a specified IP address in a five-minute period. The
@@ -546,23 +591,23 @@ module Aws::WAF
     #
     # If you add more than one predicate to a `RateBasedRule`, a request not
     # only must exceed the `RateLimit`, but it also must match all the
-    # specifications to be counted or blocked. For example, suppose you add
-    # the following to a `RateBasedRule`\:
+    # conditions to be counted or blocked. For example, suppose you add the
+    # following to a `RateBasedRule`\:
     #
     # * An `IPSet` that matches the IP address `192.0.2.44/32`
     #
     # * A `ByteMatchSet` that matches `BadBot` in the `User-Agent` header
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # You then add the `RateBasedRule` to a `WebACL` and specify that you
     # want to block requests that meet the conditions in the rule. For a
     # request to be blocked, it must come from the IP address 192.0.2.44
     # *and* the `User-Agent` header in the request must contain the value
     # `BadBot`. Further, requests that match these two conditions must be
-    # received at a rate of more than 15,000 requests every five minutes. If
+    # received at a rate of more than 1,000 requests every five minutes. If
     # both conditions are met and the rate is exceeded, AWS WAF blocks the
-    # requests. If the rate drops below 15,000 for a five-minute period, AWS
+    # requests. If the rate drops below 1,000 for a five-minute period, AWS
     # WAF no longer blocks the requests.
     #
     # As a second example, suppose you want to limit requests to a
@@ -575,7 +620,7 @@ module Aws::WAF
     #
     # * A `TargetString` of `login`
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # By adding this `RateBasedRule` to a `WebACL`, you could limit requests
     # to your login page without affecting the rest of your site.
@@ -602,11 +647,13 @@ module Aws::WAF
     #     For more information, see CreateWebACL.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RateBasedRule. You can't change
@@ -656,8 +703,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -684,6 +731,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a RegexMatchSet. You then use UpdateRegexMatchSet to identify
     # the part of a web request that you want AWS WAF to inspect, such as
     # the values of the `User-Agent` header or the query string. For
@@ -709,11 +765,13 @@ module Aws::WAF
     #     want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RegexMatchSet. You can't change
@@ -754,6 +812,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `RegexPatternSet`. You then use UpdateRegexPatternSet to
     # specify the regular expression (regex) pattern that you want AWS WAF
     # to search for, such as `B[a@]dB[o0]t`. You can then configure AWS WAF
@@ -774,11 +841,13 @@ module Aws::WAF
     #     you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RegexPatternSet. You can't
@@ -816,6 +885,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `Rule`, which contains the `IPSet` objects, `ByteMatchSet`
     # objects, and other predicates that identify the requests that you want
     # to block. If you add more than one predicate to a `Rule`, a request
@@ -852,11 +930,13 @@ module Aws::WAF
     #     information, see CreateWebACL.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the Rule. You can't change the name
@@ -916,8 +996,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -942,6 +1022,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `RuleGroup`. A rule group is a collection of predefined
     # rules that you add to a web ACL. You use UpdateRuleGroup to add rules
     # to the rule group.
@@ -956,11 +1045,13 @@ module Aws::WAF
     # * Ten rules per rule group.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the RuleGroup. You can't change
@@ -992,8 +1083,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -1014,6 +1105,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `SizeConstraintSet`. You then use UpdateSizeConstraintSet to
     # identify the part of a web request that you want AWS WAF to check for
     # length, such as the length of the `User-Agent` header or the length of
@@ -1039,11 +1139,13 @@ module Aws::WAF
     #     for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the SizeConstraintSet. You can't
@@ -1114,6 +1216,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a SqlInjectionMatchSet, which you use to allow, block, or
     # count requests that contain snippets of SQL code in a specified part
     # of web requests. AWS WAF searches for character sequences that are
@@ -1136,11 +1247,13 @@ module Aws::WAF
     #     malicious SQL code.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description for the SqlInjectionMatchSet that
@@ -1208,6 +1321,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates a `WebACL`, which contains the `Rules` that identify the
     # CloudFront web requests that you want to allow, block, or count. AWS
     # WAF evaluates `Rules` in order based on the value of `Priority` for
@@ -1240,11 +1362,13 @@ module Aws::WAF
     #     and to associate the `WebACL` with a CloudFront distribution.
     #
     # For more information about how to use the AWS WAF API, see the [AWS
-    # WAF Developer Guide][1].
+    # WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description of the WebACL. You can't change `Name`
@@ -1320,8 +1444,8 @@ module Aws::WAF
     #     change_token: "ChangeToken", # required
     #     tags: [
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -1352,6 +1476,82 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # Creates an AWS CloudFormation WAFV2 template for the specified web ACL
+    # in the specified Amazon S3 bucket. Then, in CloudFormation, you create
+    # a stack from the template, to create the web ACL and its resources in
+    # AWS WAFV2. Use this to migrate your AWS WAF Classic web ACL to the
+    # latest version of AWS WAF.
+    #
+    # This is part of a larger migration procedure for web ACLs from AWS WAF
+    # Classic to the latest version of AWS WAF. For the full procedure,
+    # including caveats and manual steps to complete the migration and
+    # switch over to the new web ACL, see [Migrating your AWS WAF Classic
+    # resources to AWS WAF][1] in the [AWS WAF Developer Guide][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-migrating-from-classic.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
+    # @option params [required, String] :web_acl_id
+    #   The UUID of the WAF Classic web ACL that you want to migrate to WAF
+    #   v2.
+    #
+    # @option params [required, String] :s3_bucket_name
+    #   The name of the Amazon S3 bucket to store the CloudFormation template
+    #   in. The S3 bucket must be configured as follows for the migration:
+    #
+    #   * The bucket name must start with `aws-waf-migration-`. For example,
+    #     `aws-waf-migration-my-web-acl`.
+    #
+    #   * The bucket must be in the Region where you are deploying the
+    #     template. For example, for a web ACL in us-west-2, you must use an
+    #     Amazon S3 bucket in us-west-2 and you must deploy the template stack
+    #     to us-west-2.
+    #
+    #   * The bucket policies must permit the migration process to write data.
+    #     For listings of the bucket policies, see the Examples section.
+    #
+    # @option params [required, Boolean] :ignore_unsupported_type
+    #   Indicates whether to exclude entities that can't be migrated or to
+    #   stop the migration. Set this to true to ignore unsupported entities in
+    #   the web ACL during the migration. Otherwise, if AWS WAF encounters
+    #   unsupported entities, it stops the process and throws an exception.
+    #
+    # @return [Types::CreateWebACLMigrationStackResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateWebACLMigrationStackResponse#s3_object_url #s3_object_url} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_web_acl_migration_stack({
+    #     web_acl_id: "ResourceId", # required
+    #     s3_bucket_name: "S3BucketName", # required
+    #     ignore_unsupported_type: false, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.s3_object_url #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/waf-2015-08-24/CreateWebACLMigrationStack AWS API Documentation
+    #
+    # @overload create_web_acl_migration_stack(params = {})
+    # @param [Hash] params ({})
+    def create_web_acl_migration_stack(params = {}, options = {})
+      req = build_request(:create_web_acl_migration_stack, params)
+      req.send_request(options)
+    end
+
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Creates an XssMatchSet, which you use to allow, block, or count
     # requests that contain cross-site scripting attacks in the specified
     # part of web requests. AWS WAF searches for character sequences that
@@ -1372,11 +1572,13 @@ module Aws::WAF
     #     scripting attacks.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :name
     #   A friendly name or description for the XssMatchSet that you're
@@ -1443,6 +1645,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a ByteMatchSet. You can't delete a `ByteMatchSet`
     # if it's still used in any `Rules` or if it still includes any
     # ByteMatchTuple objects (any filters).
@@ -1460,6 +1671,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteByteMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :byte_match_set_id
     #   The `ByteMatchSetId` of the ByteMatchSet that you want to delete.
     #   `ByteMatchSetId` is returned by CreateByteMatchSet and by
@@ -1507,6 +1723,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a GeoMatchSet. You can't delete a `GeoMatchSet`
     # if it's still used in any `Rules` or if it still includes any
     # countries.
@@ -1525,6 +1750,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteGeoMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :geo_match_set_id
     #   The `GeoMatchSetID` of the GeoMatchSet that you want to delete.
     #   `GeoMatchSetId` is returned by CreateGeoMatchSet and by
@@ -1557,6 +1787,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes an IPSet. You can't delete an `IPSet` if it's
     # still used in any `Rules` or if it still includes any IP addresses.
     #
@@ -1573,6 +1812,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteIPSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :ip_set_id
     #   The `IPSetId` of the IPSet that you want to delete. `IPSetId` is
     #   returned by CreateIPSet and by ListIPSets.
@@ -1619,9 +1863,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes the LoggingConfiguration from the specified web
     # ACL.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the web ACL from which you want to
     #   delete the LoggingConfiguration.
@@ -1643,10 +1901,24 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes an IAM policy from the specified RuleGroup.
     #
     # The user making the request must be the owner of the RuleGroup.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the RuleGroup from which you want to
     #   delete the policy.
@@ -1670,6 +1942,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RateBasedRule. You can't delete a rule if it's
     # still used in any `WebACL` objects or if it still includes any
     # predicates, such as `ByteMatchSet` objects.
@@ -1687,6 +1968,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRateBasedRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the RateBasedRule that you want to delete. `RuleId` is
     #   returned by CreateRateBasedRule and by ListRateBasedRules.
@@ -1718,6 +2004,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RegexMatchSet. You can't delete a
     # `RegexMatchSet` if it's still used in any `Rules` or if it still
     # includes any `RegexMatchTuples` objects (any filters).
@@ -1735,6 +2030,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRegexMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_match_set_id
     #   The `RegexMatchSetId` of the RegexMatchSet that you want to delete.
     #   `RegexMatchSetId` is returned by CreateRegexMatchSet and by
@@ -1767,10 +2067,24 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RegexPatternSet. You can't delete a
     # `RegexPatternSet` if it's still used in any `RegexMatchSet` or if the
     # `RegexPatternSet` is not empty.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_pattern_set_id
     #   The `RegexPatternSetId` of the RegexPatternSet that you want to
     #   delete. `RegexPatternSetId` is returned by CreateRegexPatternSet and
@@ -1803,6 +2117,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a Rule. You can't delete a `Rule` if it's still
     # used in any `WebACL` objects or if it still includes any predicates,
     # such as `ByteMatchSet` objects.
@@ -1820,6 +2143,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the Rule that you want to delete. `RuleId` is returned
     #   by CreateRule and by ListRules.
@@ -1866,6 +2194,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a RuleGroup. You can't delete a `RuleGroup` if
     # it's still used in any `WebACL` objects or if it still includes any
     # rules.
@@ -1884,6 +2221,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteRuleGroup` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup that you want to delete.
     #   `RuleGroupId` is returned by CreateRuleGroup and by ListRuleGroups.
@@ -1915,6 +2257,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a SizeConstraintSet. You can't delete a
     # `SizeConstraintSet` if it's still used in any `Rules` or if it still
     # includes any SizeConstraint objects (any filters).
@@ -1933,6 +2284,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteSizeConstraintSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :size_constraint_set_id
     #   The `SizeConstraintSetId` of the SizeConstraintSet that you want to
     #   delete. `SizeConstraintSetId` is returned by CreateSizeConstraintSet
@@ -1980,6 +2336,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a SqlInjectionMatchSet. You can't delete a
     # `SqlInjectionMatchSet` if it's still used in any `Rules` or if it
     # still contains any SqlInjectionMatchTuple objects.
@@ -1998,6 +2363,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteSqlInjectionMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :sql_injection_match_set_id
     #   The `SqlInjectionMatchSetId` of the SqlInjectionMatchSet that you want
     #   to delete. `SqlInjectionMatchSetId` is returned by
@@ -2045,6 +2415,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes a WebACL. You can't delete a `WebACL` if it still
     # contains any `Rules`.
     #
@@ -2058,6 +2437,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteWebACL` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the WebACL that you want to delete. `WebACLId` is
     #   returned by CreateWebACL and by ListWebACLs.
@@ -2104,6 +2488,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Permanently deletes an XssMatchSet. You can't delete an `XssMatchSet`
     # if it's still used in any `Rules` or if it still contains any
     # XssMatchTuple objects.
@@ -2122,6 +2515,11 @@ module Aws::WAF
     #
     # 3.  Submit a `DeleteXssMatchSet` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :xss_match_set_id
     #   The `XssMatchSetId` of the XssMatchSet that you want to delete.
     #   `XssMatchSetId` is returned by CreateXssMatchSet and by
@@ -2169,8 +2567,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the ByteMatchSet specified by `ByteMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :byte_match_set_id
     #   The `ByteMatchSetId` of the ByteMatchSet that you want to get.
     #   `ByteMatchSetId` is returned by CreateByteMatchSet and by
@@ -2234,6 +2646,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # When you want to create, update, or delete AWS WAF objects, get a
     # change token and include the change token in the create, update, or
     # delete request. Change tokens ensure that your application doesn't
@@ -2250,6 +2671,11 @@ module Aws::WAF
     # that AWS WAF is propagating the change to all AWS WAF servers. Use
     # `GetChangeTokenStatus` to determine the status of your change token.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @return [Types::GetChangeTokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetChangeTokenResponse#change_token #change_token} => String
@@ -2280,6 +2706,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the status of a `ChangeToken` that you got by calling
     # GetChangeToken. `ChangeTokenStatus` is one of the following values:
     #
@@ -2292,6 +2727,11 @@ module Aws::WAF
     #
     # * `INSYNC`\: Propagation is complete.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :change_token
     #   The change token for which you want to get the status. This change
     #   token was previously returned in the `GetChangeToken` response.
@@ -2333,8 +2773,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the GeoMatchSet that is specified by `GeoMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :geo_match_set_id
     #   The `GeoMatchSetId` of the GeoMatchSet that you want to get.
     #   `GeoMatchSetId` is returned by CreateGeoMatchSet and by
@@ -2367,8 +2821,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the IPSet that is specified by `IPSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :ip_set_id
     #   The `IPSetId` of the IPSet that you want to get. `IPSetId` is returned
     #   by CreateIPSet and by ListIPSets.
@@ -2423,8 +2891,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the LoggingConfiguration for the specified web ACL.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the web ACL for which you want to
     #   get the LoggingConfiguration.
@@ -2457,8 +2939,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the IAM policy attached to the RuleGroup.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the RuleGroup for which you want to
     #   get the policy.
@@ -2486,9 +2982,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RateBasedRule that is specified by the `RuleId` that you
     # included in the `GetRateBasedRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the RateBasedRule that you want to get. `RuleId` is
     #   returned by CreateRateBasedRule and by ListRateBasedRules.
@@ -2524,12 +3034,26 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of IP addresses currently being blocked by the
     # RateBasedRule that is specified by the `RuleId`. The maximum number of
     # managed keys that will be blocked is 10,000. If more than 10,000
     # addresses exceed the rate limit, the 10,000 addresses with the highest
     # rates will be blocked.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the RateBasedRule for which you want to get a list of
     #   `ManagedKeys`. `RuleId` is returned by CreateRateBasedRule and by
@@ -2566,8 +3090,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RegexMatchSet specified by `RegexMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_match_set_id
     #   The `RegexMatchSetId` of the RegexMatchSet that you want to get.
     #   `RegexMatchSetId` is returned by CreateRegexMatchSet and by
@@ -2602,8 +3140,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RegexPatternSet specified by `RegexPatternSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :regex_pattern_set_id
     #   The `RegexPatternSetId` of the RegexPatternSet that you want to get.
     #   `RegexPatternSetId` is returned by CreateRegexPatternSet and by
@@ -2635,9 +3187,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the Rule that is specified by the `RuleId` that you included
     # in the `GetRule` request.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the Rule that you want to get. `RuleId` is returned by
     #   CreateRule and by ListRules.
@@ -2696,11 +3262,25 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the RuleGroup that is specified by the `RuleGroupId` that you
     # included in the `GetRuleGroup` request.
     #
     # To view the rules in a rule group, use ListActivatedRulesInRuleGroup.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup that you want to get. `RuleGroupId`
     #   is returned by CreateRuleGroup and by ListRuleGroups.
@@ -2730,6 +3310,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Gets detailed information about a specified number of requests--a
     # sample--that AWS WAF randomly selects from among the first 5,000
     # requests that your AWS resource received during a time range that you
@@ -2743,6 +3332,11 @@ module Aws::WAF
     # range. This new time range indicates the actual period during which
     # AWS WAF selected the requests in the sample.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the `WebACL` for which you want `GetSampledRequests`
     #   to return a sample of requests.
@@ -2761,7 +3355,8 @@ module Aws::WAF
     # @option params [required, Types::TimeWindow] :time_window
     #   The start date and time and the end date and time of the range for
     #   which you want `GetSampledRequests` to return a sample of requests.
-    #   Specify the date and time in the following format:
+    #   You must specify the times in Coordinated Universal Time (UTC) format.
+    #   UTC format includes the special designator, `Z`. For example,
     #   `"2016-09-27T14:50Z"`. You can specify any time range in the previous
     #   three hours.
     #
@@ -2863,8 +3458,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the SizeConstraintSet specified by `SizeConstraintSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :size_constraint_set_id
     #   The `SizeConstraintSetId` of the SizeConstraintSet that you want to
     #   get. `SizeConstraintSetId` is returned by CreateSizeConstraintSet and
@@ -2928,9 +3537,23 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the SqlInjectionMatchSet that is specified by
     # `SqlInjectionMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :sql_injection_match_set_id
     #   The `SqlInjectionMatchSetId` of the SqlInjectionMatchSet that you want
     #   to get. `SqlInjectionMatchSetId` is returned by
@@ -2990,8 +3613,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the WebACL that is specified by `WebACLId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the WebACL that you want to get. `WebACLId` is
     #   returned by CreateWebACL and by ListWebACLs.
@@ -3061,8 +3698,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns the XssMatchSet that is specified by `XssMatchSetId`.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :xss_match_set_id
     #   The `XssMatchSetId` of the XssMatchSet that you want to get.
     #   `XssMatchSetId` is returned by CreateXssMatchSet and by
@@ -3121,8 +3772,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of ActivatedRule objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup for which you want to get a list of
     #   ActivatedRule objects.
@@ -3176,8 +3841,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of ByteMatchSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `ByteMatchSets`
     #   than the value of `Limit`, AWS WAF returns a `NextMarker` value in the
@@ -3221,8 +3900,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of GeoMatchSetSummary objects in the response.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `GeoMatchSet`s
     #   than the value of `Limit`, AWS WAF returns a `NextMarker` value in the
@@ -3266,8 +3959,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of IPSetSummary objects in the response.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   AWS WAF returns a `NextMarker` value in the response that allows you
     #   to list another group of `IPSets`. For the second and subsequent
@@ -3327,8 +4034,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of LoggingConfiguration objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   `LoggingConfigurations` than the value of `Limit`, AWS WAF returns a
@@ -3377,8 +4098,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `Rules` than the
     #   value of `Limit`, AWS WAF returns a `NextMarker` value in the response
@@ -3421,8 +4156,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RegexMatchSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `RegexMatchSet`
     #   objects than the value of `Limit`, AWS WAF returns a `NextMarker`
@@ -3466,8 +4215,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RegexPatternSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `RegexPatternSet`
     #   objects than the value of `Limit`, AWS WAF returns a `NextMarker`
@@ -3512,8 +4275,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleGroup objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `RuleGroups` than
     #   the value of `Limit`, AWS WAF returns a `NextMarker` value in the
@@ -3556,8 +4333,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `Rules` than the
     #   value of `Limit`, AWS WAF returns a `NextMarker` value in the response
@@ -3619,8 +4410,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of SizeConstraintSetSummary objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   `SizeConstraintSets` than the value of `Limit`, AWS WAF returns a
@@ -3684,8 +4489,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of SqlInjectionMatchSet objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   SqlInjectionMatchSet objects than the value of `Limit`, AWS WAF
@@ -3749,8 +4568,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of RuleGroup objects that you are subscribed to.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more
     #   `ByteMatchSets`subscribed rule groups than the value of `Limit`, AWS
@@ -3795,6 +4628,32 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    # Retrieves the tags associated with the specified AWS resource. Tags
+    # are key:value pairs that you can use to categorize and manage your
+    # resources, for purposes like billing. For example, you might set the
+    # tag key to "customer" and the value to the customer name or ID. You
+    # can specify one or more tags to add to each AWS resource, up to 50
+    # tags for a resource.
+    #
+    # Tagging is only available through the API, SDKs, and CLI. You can't
+    # manage or view tags through the AWS WAF Classic console. You can tag
+    # the AWS resources that you manage through AWS WAF Classic: web ACLs,
+    # rule groups, and rules.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #
     # @option params [Integer] :limit
@@ -3831,8 +4690,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of WebACLSummary objects in the response.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more `WebACL` objects
     #   than the number that you specify for `Limit`, AWS WAF returns a
@@ -3895,8 +4768,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Returns an array of XssMatchSet objects.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [String] :next_marker
     #   If you specify a value for `Limit` and you have more XssMatchSet
     #   objects than the value of `Limit`, AWS WAF returns a `NextMarker`
@@ -3958,6 +4845,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Associates a LoggingConfiguration with a specified web ACL.
     #
     # You can access information about all traffic that AWS WAF inspects
@@ -3980,12 +4876,14 @@ module Aws::WAF
     # When you successfully enable logging using a `PutLoggingConfiguration`
     # request, AWS WAF will create a service linked role with the necessary
     # permissions to write logs to the Amazon Kinesis Data Firehose. For
-    # more information, see [Logging Web ACL Traffic Information][1] in the
+    # more information, see [Logging Web ACL Traffic Information][3] in the
     # *AWS WAF Developer Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/logging.html
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/logging.html
     #
     # @option params [required, Types::LoggingConfiguration] :logging_configuration
     #   The Amazon Kinesis Data Firehose that contains the inspected traffic
@@ -4034,7 +4932,16 @@ module Aws::WAF
       req.send_request(options)
     end
 
-    # Attaches a IAM policy to the specified resource. The only supported
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    # Attaches an IAM policy to the specified resource. The only supported
     # use for this action is to share a RuleGroup across accounts.
     #
     # The `PutPermissionPolicy` is subject to the following restrictions:
@@ -4060,14 +4967,16 @@ module Aws::WAF
     #
     # * Your policy must be composed using IAM Policy version 2012-10-17.
     #
-    # For more information, see [IAM Policies][1].
+    # For more information, see [IAM Policies][3].
     #
     # An example of a valid policy parameter is shown in the Examples
     # section below.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the RuleGroup to which you want to
@@ -4094,6 +5003,32 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    # Associates tags with the specified AWS resource. Tags are key:value
+    # pairs that you can use to categorize and manage your resources, for
+    # purposes like billing. For example, you might set the tag key to
+    # "customer" and the value to the customer name or ID. You can specify
+    # one or more tags to add to each AWS resource, up to 50 tags for a
+    # resource.
+    #
+    # Tagging is only available through the API, SDKs, and CLI. You can't
+    # manage or view tags through the AWS WAF Classic console. You can use
+    # this action to tag the AWS resources that you manage through AWS WAF
+    # Classic: web ACLs, rule groups, and rules.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #
     # @option params [required, Array<Types::Tag>] :tags
@@ -4106,8 +5041,8 @@ module Aws::WAF
     #     resource_arn: "ResourceArn", # required
     #     tags: [ # required
     #       {
-    #         key: "TagKey",
-    #         value: "TagValue",
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
     #       },
     #     ],
     #   })
@@ -4121,6 +5056,22 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
+    #
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :resource_arn
     #
     # @option params [required, Array<String>] :tag_keys
@@ -4143,6 +5094,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet.
     # For each `ByteMatchTuple` object, you specify the following values:
     #
@@ -4182,11 +5142,13 @@ module Aws::WAF
     #     or the URI) and the value that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :byte_match_set_id
     #   The `ByteMatchSetId` of the ByteMatchSet that you want to update.
@@ -4276,6 +5238,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes GeoMatchConstraint objects in an `GeoMatchSet`. For
     # each `GeoMatchConstraint` object, you specify the following values:
     #
@@ -4304,11 +5275,13 @@ module Aws::WAF
     # change a country, you delete the existing country and add the new one.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :geo_match_set_id
     #   The `GeoMatchSetId` of the GeoMatchSet that you want to update.
@@ -4364,6 +5337,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes IPSetDescriptor objects in an `IPSet`. For each
     # `IPSetDescriptor` object, you specify the following values:
     #
@@ -4380,7 +5362,7 @@ module Aws::WAF
     # AWS WAF supports IPv4 address ranges: /8 and any range between /16
     # through /32. AWS WAF supports IPv6 address ranges: /24, /32, /48, /56,
     # /64, and /128. For more information about CIDR notation, see the
-    # Wikipedia entry [Classless Inter-Domain Routing][1].
+    # Wikipedia entry [Classless Inter-Domain Routing][3].
     #
     # IPv6 addresses can be represented using any of the following formats:
     #
@@ -4417,12 +5399,14 @@ module Aws::WAF
     # You can insert a maximum of 1000 addresses in a single request.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][2].
+    # block HTTP requests, see the [AWS WAF Developer Guide][4].
     #
     #
     #
-    # [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
-    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
+    # [4]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :ip_set_id
     #   The `IPSetId` of the IPSet that you want to update. `IPSetId` is
@@ -4500,6 +5484,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes Predicate objects in a rule and updates the
     # `RateLimit` in the rule.
     #
@@ -4517,14 +5510,14 @@ module Aws::WAF
     #
     # * A `ByteMatchSet` that matches `BadBot` in the `User-Agent` header
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # You then add the `RateBasedRule` to a `WebACL` and specify that you
     # want to block requests that satisfy the rule. For a request to be
     # blocked, it must come from the IP address 192.0.2.44 *and* the
     # `User-Agent` header in the request must contain the value `BadBot`.
     # Further, requests that match these two conditions much be received at
-    # a rate of more than 15,000 every five minutes. If the rate drops below
+    # a rate of more than 1,000 every five minutes. If the rate drops below
     # this limit, AWS WAF no longer blocks the requests.
     #
     # As a second example, suppose you want to limit requests to a
@@ -4537,11 +5530,16 @@ module Aws::WAF
     #
     # * A `TargetString` of `login`
     #
-    # Further, you specify a `RateLimit` of 15,000.
+    # Further, you specify a `RateLimit` of 1,000.
     #
     # By adding this `RateBasedRule` to a `WebACL`, you could limit requests
     # to your login page without affecting the rest of your site.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the `RateBasedRule` that you want to update. `RuleId`
     #   is returned by `CreateRateBasedRule` and by ListRateBasedRules.
@@ -4595,6 +5593,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes RegexMatchTuple objects (filters) in a
     # RegexMatchSet. For each `RegexMatchSetUpdate` object, you specify the
     # following values:
@@ -4634,11 +5641,13 @@ module Aws::WAF
     #     for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :regex_match_set_id
     #   The `RegexMatchSetId` of the RegexMatchSet that you want to update.
@@ -4690,6 +5699,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes `RegexPatternString` objects in a RegexPatternSet.
     # For each `RegexPatternString` object, you specify the following
     # values:
@@ -4723,11 +5741,13 @@ module Aws::WAF
     #     expression pattern that you want AWS WAF to watch for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :regex_pattern_set_id
     #   The `RegexPatternSetId` of the RegexPatternSet that you want to
@@ -4771,6 +5791,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes Predicate objects in a `Rule`. Each `Predicate`
     # object identifies a predicate, such as a ByteMatchSet or an IPSet,
     # that specifies the web requests that you want to allow, block, or
@@ -4807,11 +5836,13 @@ module Aws::WAF
     # delete the existing one and add the new one.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :rule_id
     #   The `RuleId` of the `Rule` that you want to update. `RuleId` is
@@ -4890,6 +5921,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes ActivatedRule objects in a `RuleGroup`.
     #
     # You can only insert `REGULAR` rules into a rule group.
@@ -4914,11 +5954,13 @@ module Aws::WAF
     # existing one and add the new one.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :rule_group_id
     #   The `RuleGroupId` of the RuleGroup that you want to update.
@@ -4984,6 +6026,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes SizeConstraint objects (filters) in a
     # SizeConstraintSet. For each `SizeConstraint` object, you specify the
     # following values:
@@ -5032,11 +6083,13 @@ module Aws::WAF
     #     for.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :size_constraint_set_id
     #   The `SizeConstraintSetId` of the SizeConstraintSet that you want to
@@ -5125,6 +6178,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes SqlInjectionMatchTuple objects (filters) in a
     # SqlInjectionMatchSet. For each `SqlInjectionMatchTuple` object, you
     # specify the following values:
@@ -5163,11 +6225,13 @@ module Aws::WAF
     #     snippets of SQL code.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :sql_injection_match_set_id
     #   The `SqlInjectionMatchSetId` of the `SqlInjectionMatchSet` that you
@@ -5253,6 +6317,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes ActivatedRule objects in a `WebACL`. Each `Rule`
     # identifies web requests that you want to allow, block, or count. When
     # you update a `WebACL`, you specify the following values:
@@ -5298,14 +6371,14 @@ module Aws::WAF
     #     and to associate the `WebACL` with a CloudFront distribution.
     #
     #     The `ActivatedRule` can be a rule group. If you specify a rule
-    #     group as your `ActivatedRule`, you can exclude specific rules from
-    #     that rule group.
+    #     group as your `ActivatedRule` , you can exclude specific rules
+    #     from that rule group.
     #
     #     If you already have a rule group associated with a web ACL and
     #     want to submit an `UpdateWebACL` request to exclude certain rules
     #     from that rule group, you must first remove the rule group from
     #     the web ACL, the re-insert it again, specifying the excluded
-    #     rules. For details, see ActivatedRule$ExcludedRules.
+    #     rules. For details, see ActivatedRule$ExcludedRules .
     #
     # Be aware that if you try to add a RATE\_BASED rule to a web ACL
     # without setting the rule type when first creating the rule, the
@@ -5314,11 +6387,13 @@ module Aws::WAF
     # not exist.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :web_acl_id
     #   The `WebACLId` of the WebACL that you want to update. `WebACLId` is
@@ -5428,6 +6503,15 @@ module Aws::WAF
       req.send_request(options)
     end
 
+    # <note markdown="1"> This is **AWS WAF Classic** documentation. For more information, see
+    # [AWS WAF Classic][1] in the developer guide.
+    #
+    #  **For the latest version of AWS WAF**, use the AWS WAFV2 API and see
+    # the [AWS WAF Developer Guide][2]. With the latest version, AWS WAF has
+    # a single set of endpoints for regional and global use.
+    #
+    #  </note>
+    #
     # Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet.
     # For each `XssMatchTuple` object, you specify the following values:
     #
@@ -5464,11 +6548,13 @@ module Aws::WAF
     #     attacks.
     #
     # For more information about how to use the AWS WAF API to allow or
-    # block HTTP requests, see the [AWS WAF Developer Guide][1].
+    # block HTTP requests, see the [AWS WAF Developer Guide][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html
+    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
+    # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :xss_match_set_id
     #   The `XssMatchSetId` of the `XssMatchSet` that you want to update.
@@ -5565,7 +6651,7 @@ module Aws::WAF
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-waf'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.28.0'
       Seahorse::Client::Request.new(handlers, context)
     end