aws-sdk-wafv2 1.35.0 → 1.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e3e10c76d8225b5be56a937527506820b8a2132d2a3e740442da28a06d0f218
-  data.tar.gz: 4ad816d40170387c5f52c2438a3477abcfbe52f3667ae392d270234112bf01d3
+  metadata.gz: 1d973a73831a330731946dc07a6c2b3e29bbc307195b41420305996b5b7ad65e
+  data.tar.gz: 8021de5c4a20e79659c8108941d6e3fbce250760e793735e75051bfca3eb5930
 SHA512:
-  metadata.gz: e9137dc0e7f7e99c3aa1b34e76ca3426692ae7d2d670e1fedd1a66d051d42c18d5ca6067a8327c0b030ba2e419b946328a21f859b56d970bdd2f665faf6f94fc
-  data.tar.gz: b4d5f86db2a1517a8cfaf226ab34b3ec382dcbd9d1d625a85697903134cfa62c9f22fe34cebb3a12e790287cd178195b837791cf54224921ebe31f6f46c09f20
+  metadata.gz: 370322bdb3c2f6c1f6eded02b34194c6750ae1a506bcd38653a437141cab66704cca355994b2130b02b01277eca8d7bb2fee3998476ec223b550fac2c53f7575
+  data.tar.gz: 5ea7f55d8403ddec9a0e6c72fd2a8016de84409ed2b68a740ed93f89a3ee37ded64f612ee7550d1f7ce616d80aad30495bb59de00a95723be3b0547ee624d3d3

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.36.0 (2022-02-22)
+------------------
+
+* Feature - Updated descriptions for logging configuration.
+
 1.35.0 (2022-02-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.35.0
+1.36.0

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

@@ -875,11 +875,11 @@ module Aws::WAFV2
     #   The version of the IP addresses, either `IPV4` or `IPV6`.
     #
     # @option params [required, Array<String>] :addresses
-    #   Contains an array of strings that specify one or more IP addresses or
-    #   blocks of IP addresses in Classless Inter-Domain Routing (CIDR)
+    #   Contains an array of strings that specifies zero or more IP addresses
+    #   or blocks of IP addresses in Classless Inter-Domain Routing (CIDR)
     #   notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
     #
-    #   Examples:
+    #   Example address strings:
     #
     #   * To configure WAF to allow, block, or count requests that originated
     #     from the IP address 192.0.2.44, specify `192.0.2.44/32`.
@@ -900,6 +900,17 @@ module Aws::WAFV2
     #   For more information about CIDR notation, see the Wikipedia entry
     #   [Classless Inter-Domain Routing][1].
     #
+    #   Example JSON `Addresses` specifications:
+    #
+    #   * Empty array: `"Addresses": []`
+    #
+    #   * Array with one address: `"Addresses": ["192.0.2.44/32"]`
+    #
+    #   * Array with three addresses: `"Addresses": ["192.0.2.44/32",
+    #     "192.0.2.0/24", "192.0.0.0/16"]`
+    #
+    #   * INVALID specification: `"Addresses": [""]` INVALID
+    #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
@@ -2502,7 +2513,12 @@ module Aws::WAFV2
     # The mobile SDK is not generally available. Customers who have access
     # to the mobile SDK can use it to establish and manage Security Token
     # Service (STS) security tokens for use in HTTP(S) requests from a
-    # mobile device to WAF.
+    # mobile device to WAF. For more information, see [WAF client
+    # application integration][1] in the *WAF Developer Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html
     #
     # @option params [required, String] :platform
     #   The device platform.
@@ -2723,7 +2739,12 @@ module Aws::WAFV2
     # The mobile SDK is not generally available. Customers who have access
     # to the mobile SDK can use it to establish and manage Security Token
     # Service (STS) security tokens for use in HTTP(S) requests from a
-    # mobile device to WAF.
+    # mobile device to WAF. For more information, see [WAF client
+    # application integration][1] in the *WAF Developer Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html
     #
     # @option params [required, String] :platform
     #   The device platform.
@@ -4367,7 +4388,12 @@ module Aws::WAFV2
     # The mobile SDK is not generally available. Customers who have access
     # to the mobile SDK can use it to establish and manage Security Token
     # Service (STS) security tokens for use in HTTP(S) requests from a
-    # mobile device to WAF.
+    # mobile device to WAF. For more information, see [WAF client
+    # application integration][1] in the *WAF Developer Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html
     #
     # @option params [required, String] :platform
     #   The device platform to retrieve the list for.
@@ -4698,7 +4724,11 @@ module Aws::WAFV2
     # Enables the specified LoggingConfiguration, to start logging from a
     # web ACL, according to the configuration provided.
     #
-    # You can access information about all traffic that WAF inspects using
+    # <note markdown="1"> You can define one logging destination per web ACL.
+    #
+    #  </note>
+    #
+    # You can access information about the traffic that WAF inspects using
     # the following steps:
     #
     # 1.  Create your logging destination. You can use an Amazon CloudWatch
@@ -4718,6 +4748,9 @@ module Aws::WAFV2
     # Amazon S3 bucket, WAF creates a bucket policy. For an Amazon Kinesis
     # Data Firehose, WAF creates a service-linked role.
     #
+    # For additional information about web ACL logging, see [Logging web ACL
+    # traffic information][1] in the *WAF Developer Guide*.
+    #
     # <note markdown="1"> This operation completely replaces the mutable specifications that you
     # already have for the logging configuration with the ones that you
     # provide to this call. To modify the logging configuration, retrieve it
@@ -5100,11 +5133,11 @@ module Aws::WAFV2
     #   A description of the IP set that helps with identification.
     #
     # @option params [required, Array<String>] :addresses
-    #   Contains an array of strings that specify one or more IP addresses or
-    #   blocks of IP addresses in Classless Inter-Domain Routing (CIDR)
+    #   Contains an array of strings that specifies zero or more IP addresses
+    #   or blocks of IP addresses in Classless Inter-Domain Routing (CIDR)
     #   notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
     #
-    #   Examples:
+    #   Example address strings:
     #
     #   * To configure WAF to allow, block, or count requests that originated
     #     from the IP address 192.0.2.44, specify `192.0.2.44/32`.
@@ -5125,6 +5158,17 @@ module Aws::WAFV2
     #   For more information about CIDR notation, see the Wikipedia entry
     #   [Classless Inter-Domain Routing][1].
     #
+    #   Example JSON `Addresses` specifications:
+    #
+    #   * Empty array: `"Addresses": []`
+    #
+    #   * Array with one address: `"Addresses": ["192.0.2.44/32"]`
+    #
+    #   * Array with three addresses: `"Addresses": ["192.0.2.44/32",
+    #     "192.0.2.0/24", "192.0.0.0/16"]`
+    #
+    #   * INVALID specification: `"Addresses": [""]` INVALID
+    #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
@@ -6396,7 +6440,7 @@ module Aws::WAFV2
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-wafv2'
-      context[:gem_version] = '1.35.0'
+      context[:gem_version] = '1.36.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1336,11 +1336,12 @@ module Aws::WAFV2
     #   @return [String]
     #
     # @!attribute [rw] addresses
-    #   Contains an array of strings that specify one or more IP addresses
-    #   or blocks of IP addresses in Classless Inter-Domain Routing (CIDR)
-    #   notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
+    #   Contains an array of strings that specifies zero or more IP
+    #   addresses or blocks of IP addresses in Classless Inter-Domain
+    #   Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges
+    #   except for /0.
     #
-    #   Examples:
+    #   Example address strings:
     #
     #   * To configure WAF to allow, block, or count requests that
     #     originated from the IP address 192.0.2.44, specify
@@ -1364,6 +1365,17 @@ module Aws::WAFV2
     #   For more information about CIDR notation, see the Wikipedia entry
     #   [Classless Inter-Domain Routing][1].
     #
+    #   Example JSON `Addresses` specifications:
+    #
+    #   * Empty array: `"Addresses": []`
+    #
+    #   * Array with one address: `"Addresses": ["192.0.2.44/32"]`
+    #
+    #   * Array with three addresses: `"Addresses": ["192.0.2.44/32",
+    #     "192.0.2.0/24", "192.0.0.0/16"]`
+    #
+    #   * INVALID specification: `"Addresses": [""]` INVALID
+    #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
@@ -4400,7 +4412,7 @@ module Aws::WAFV2
     #   account takeover prevention managed rule group
     #   `AWSManagedRulesATPRuleSet`. This is only populated if you are using
     #   a rule group in your web ACL that integrates with your applications
-    #   in this way. For more information, see [WAF application
+    #   in this way. For more information, see [WAF client application
     #   integration][1] in the *WAF Developer Guide*.
     #
     #
@@ -4498,7 +4510,7 @@ module Aws::WAFV2
       include Aws::Structure
     end
 
-    # Contains one or more IP addresses or blocks of IP addresses specified
+    # Contains zero or more IP addresses or blocks of IP addresses specified
     # in Classless Inter-Domain Routing (CIDR) notation. WAF supports all
     # IPv4 and IPv6 CIDR ranges except for /0. For information about CIDR
     # notation, see the Wikipedia entry [Classless Inter-Domain Routing][1].
@@ -4535,11 +4547,12 @@ module Aws::WAFV2
     #   @return [String]
     #
     # @!attribute [rw] addresses
-    #   Contains an array of strings that specify one or more IP addresses
-    #   or blocks of IP addresses in Classless Inter-Domain Routing (CIDR)
-    #   notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
+    #   Contains an array of strings that specifies zero or more IP
+    #   addresses or blocks of IP addresses in Classless Inter-Domain
+    #   Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges
+    #   except for /0.
     #
-    #   Examples:
+    #   Example address strings:
     #
     #   * To configure WAF to allow, block, or count requests that
     #     originated from the IP address 192.0.2.44, specify
@@ -4563,6 +4576,17 @@ module Aws::WAFV2
     #   For more information about CIDR notation, see the Wikipedia entry
     #   [Classless Inter-Domain Routing][1].
     #
+    #   Example JSON `Addresses` specifications:
+    #
+    #   * Empty array: `"Addresses": []`
+    #
+    #   * Array with one address: `"Addresses": ["192.0.2.44/32"]`
+    #
+    #   * Array with three addresses: `"Addresses": ["192.0.2.44/32",
+    #     "192.0.2.0/24", "192.0.0.0/16"]`
+    #
+    #   * INVALID specification: `"Addresses": [""]` INVALID
+    #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
@@ -5768,8 +5792,32 @@ module Aws::WAFV2
     # and you can specify filters so that you log only a subset of the
     # logging records.
     #
-    # For information about configuring web ACL logging destinations, see
-    # [Logging web ACL traffic information][1] in the *WAF Developer Guide*.
+    # <note markdown="1"> You can define one logging destination per web ACL.
+    #
+    #  </note>
+    #
+    # You can access information about the traffic that WAF inspects using
+    # the following steps:
+    #
+    # 1.  Create your logging destination. You can use an Amazon CloudWatch
+    #     Logs log group, an Amazon Simple Storage Service (Amazon S3)
+    #     bucket, or an Amazon Kinesis Data Firehose. For information about
+    #     configuring logging destinations and the permissions that are
+    #     required for each, see [Logging web ACL traffic information][1] in
+    #     the *WAF Developer Guide*.
+    #
+    # 2.  Associate your logging destination to your web ACL using a
+    #     `PutLoggingConfiguration` request.
+    #
+    # When you successfully enable logging using a `PutLoggingConfiguration`
+    # request, WAF creates an additional role or policy that is required to
+    # write logs to the logging destination. For an Amazon CloudWatch Logs
+    # log group, WAF creates a resource policy on the log group. For an
+    # Amazon S3 bucket, WAF creates a bucket policy. For an Amazon Kinesis
+    # Data Firehose, WAF creates a service-linked role.
+    #
+    # For additional information about web ACL logging, see [Logging web ACL
+    # traffic information][1] in the *WAF Developer Guide*.
     #
     #
     #
@@ -5838,8 +5886,12 @@ module Aws::WAFV2
     #   @return [String]
     #
     # @!attribute [rw] log_destination_configs
-    #   The Amazon Resource Names (ARNs) of the logging destinations that
-    #   you want to associate with the web ACL.
+    #   The logging destination configuration that you want to associate
+    #   with the web ACL.
+    #
+    #   <note markdown="1"> You can associate one logging destination to a web ACL.
+    #
+    #    </note>
     #   @return [Array<String>]
     #
     # @!attribute [rw] redacted_fields
@@ -5947,8 +5999,9 @@ module Aws::WAFV2
     #       }
     #
     # @!attribute [rw] login_path
-    #   The login endpoint for your application. For example
-    #   `https://example.com/web/login`.
+    #   The path of the login endpoint for your application. For example,
+    #   for the URL `https://example.com/web/login`, you would provide the
+    #   path `/web/login`.
     #   @return [String]
     #
     # @!attribute [rw] payload_type
@@ -6671,7 +6724,12 @@ module Aws::WAFV2
     # The mobile SDK is not generally available. Customers who have access
     # to the mobile SDK can use it to establish and manage Security Token
     # Service (STS) security tokens for use in HTTP(S) requests from a
-    # mobile device to WAF.
+    # mobile device to WAF. For more information, see [WAF client
+    # application integration][1] in the *WAF Developer Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html
     #
     # @!attribute [rw] release_version
     #   The release version.
@@ -11830,11 +11888,12 @@ module Aws::WAFV2
     #   @return [String]
     #
     # @!attribute [rw] addresses
-    #   Contains an array of strings that specify one or more IP addresses
-    #   or blocks of IP addresses in Classless Inter-Domain Routing (CIDR)
-    #   notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0.
+    #   Contains an array of strings that specifies zero or more IP
+    #   addresses or blocks of IP addresses in Classless Inter-Domain
+    #   Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges
+    #   except for /0.
     #
-    #   Examples:
+    #   Example address strings:
     #
     #   * To configure WAF to allow, block, or count requests that
     #     originated from the IP address 192.0.2.44, specify
@@ -11858,6 +11917,17 @@ module Aws::WAFV2
     #   For more information about CIDR notation, see the Wikipedia entry
     #   [Classless Inter-Domain Routing][1].
     #
+    #   Example JSON `Addresses` specifications:
+    #
+    #   * Empty array: `"Addresses": []`
+    #
+    #   * Array with one address: `"Addresses": ["192.0.2.44/32"]`
+    #
+    #   * Array with three addresses: `"Addresses": ["192.0.2.44/32",
+    #     "192.0.2.0/24", "192.0.0.0/16"]`
+    #
+    #   * INVALID specification: `"Addresses": [""]` INVALID
+    #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing

data/lib/aws-sdk-wafv2.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-wafv2/customizations'
 # @!group service
 module Aws::WAFV2
 
-  GEM_VERSION = '1.35.0'
+  GEM_VERSION = '1.36.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-wafv2
 version: !ruby/object:Gem::Version
-  version: 1.35.0
+  version: 1.36.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-10 00:00:00.000000000 Z
+date: 2022-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core