aws-sdk-waf 1.0.0.rc8 → 1.0.0.rc9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 663905a7b3208929449c414eb0e1e983a772e1e4
-  data.tar.gz: 8edaf15d950ba9089938d286c197277dbf614a8f
+  metadata.gz: d3294d6d7630be316c280b3d894fe1229f85dffd
+  data.tar.gz: 9511cc0b15364029e83470ec492288c8c7003095
 SHA512:
-  metadata.gz: cfdd0d1f5e06053b2a9711b223194fa266fb8cd735ce32b2a5652fdf6ddb53321c6055ceee08991afc0f428fa9cc9c39a1c3c62992f209ada54d9ff86ae2378b
-  data.tar.gz: dab98399f11222f93162bdd7ccda2faa9ca6c34e337bcd4c8cc10cba2767f98276458002e05ccaaeb5f052b03e0a153e995f1e64a84f7dc283b0721568867ed7
+  metadata.gz: 56ef40f24efd3717fab17b6f7e8c6728d67613591c9b4d6f5af57dbc4dddc4844294af6ddfe2121ac48e31f75f45e6a36cfc713169872ba215f98210693e53c9
+  data.tar.gz: e82c3bf3b1c83f158a69771f75f91fcee29e4c5e0b1fba0a57317cfa209fec174db20f946bd0bd406eee8935ad2f9f69e4dc0180d0d2165c2e3539db0b25d662

data/lib/aws-sdk-waf.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-waf/customizations'
 # @service
 module Aws::WAF
 
-  GEM_VERSION = '1.0.0.rc8'
+  GEM_VERSION = '1.0.0.rc9'
 
 end

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

@@ -263,6 +263,31 @@ module Aws::WAF
     #   * {Types::CreateIPSetResponse#ip_set #ip_set} => Types::IPSet
     #   * {Types::CreateIPSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To create an IP set
+    #
+    #   # The following example creates an IP match set named MyIPSetFriendlyName.
+    #
+    #   resp = client.create_ip_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     name: "MyIPSetFriendlyName", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     ip_set: {
+    #       ip_set_descriptors: [
+    #         {
+    #           type: "IPV4", 
+    #           value: "192.0.2.44/32", 
+    #         }, 
+    #       ], 
+    #       ip_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       name: "MyIPSetFriendlyName", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_ip_set({
@@ -485,6 +510,34 @@ module Aws::WAF
     #   * {Types::CreateRuleResponse#rule #rule} => Types::Rule
     #   * {Types::CreateRuleResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To create a rule
+    #
+    #   # The following example creates a rule named WAFByteHeaderRule.
+    #
+    #   resp = client.create_rule({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     metric_name: "WAFByteHeaderRule", 
+    #     name: "WAFByteHeaderRule", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     rule: {
+    #       metric_name: "WAFByteHeaderRule", 
+    #       name: "WAFByteHeaderRule", 
+    #       predicates: [
+    #         {
+    #           data_id: "MyByteMatchSetID", 
+    #           negated: false, 
+    #           type: "ByteMatch", 
+    #         }, 
+    #       ], 
+    #       rule_id: "WAFRule-1-Example", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_rule({
@@ -556,6 +609,35 @@ module Aws::WAF
     #   * {Types::CreateSizeConstraintSetResponse#size_constraint_set #size_constraint_set} => Types::SizeConstraintSet
     #   * {Types::CreateSizeConstraintSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To create a size constraint
+    #
+    #   # The following example creates size constraint set named MySampleSizeConstraintSet.
+    #
+    #   resp = client.create_size_constraint_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     name: "MySampleSizeConstraintSet", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     size_constraint_set: {
+    #       name: "MySampleSizeConstraintSet", 
+    #       size_constraint_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       size_constraints: [
+    #         {
+    #           comparison_operator: "GT", 
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           size: 0, 
+    #           text_transformation: "NONE", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_size_constraint_set({
@@ -625,6 +707,33 @@ module Aws::WAF
     #   * {Types::CreateSqlInjectionMatchSetResponse#sql_injection_match_set #sql_injection_match_set} => Types::SqlInjectionMatchSet
     #   * {Types::CreateSqlInjectionMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To create a SQL injection match set
+    #
+    #   # The following example creates a SQL injection match set named MySQLInjectionMatchSet.
+    #
+    #   resp = client.create_sql_injection_match_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     name: "MySQLInjectionMatchSet", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     sql_injection_match_set: {
+    #       name: "MySQLInjectionMatchSet", 
+    #       sql_injection_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       sql_injection_match_tuples: [
+    #         {
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           text_transformation: "URL_DECODE", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_sql_injection_match_set({
@@ -712,6 +821,42 @@ module Aws::WAF
     #   * {Types::CreateWebACLResponse#web_acl #web_acl} => Types::WebACL
     #   * {Types::CreateWebACLResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To create a web ACL
+    #
+    #   # The following example creates a web ACL named CreateExample.
+    #
+    #   resp = client.create_web_acl({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     default_action: {
+    #       type: "ALLOW", 
+    #     }, 
+    #     metric_name: "CreateExample", 
+    #     name: "CreateExample", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     web_acl: {
+    #       default_action: {
+    #         type: "ALLOW", 
+    #       }, 
+    #       metric_name: "CreateExample", 
+    #       name: "CreateExample", 
+    #       rules: [
+    #         {
+    #           action: {
+    #             type: "ALLOW", 
+    #           }, 
+    #           priority: 1, 
+    #           rule_id: "WAFRule-1-Example", 
+    #         }, 
+    #       ], 
+    #       web_acl_id: "example-46da-4444-5555-example", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_web_acl({
@@ -783,6 +928,33 @@ module Aws::WAF
     #   * {Types::CreateXssMatchSetResponse#xss_match_set #xss_match_set} => Types::XssMatchSet
     #   * {Types::CreateXssMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To create an XSS match set
+    #
+    #   # The following example creates an XSS match set named MySampleXssMatchSet.
+    #
+    #   resp = client.create_xss_match_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     name: "MySampleXssMatchSet", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     xss_match_set: {
+    #       name: "MySampleXssMatchSet", 
+    #       xss_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       xss_match_tuples: [
+    #         {
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           text_transformation: "URL_DECODE", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_xss_match_set({
@@ -838,6 +1010,21 @@ module Aws::WAF
     #
     #   * {Types::DeleteByteMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To delete a byte match set
+    #
+    #   # The following example deletes a byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.delete_byte_match_set({
+    #     byte_match_set_id: "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", 
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_byte_match_set({
@@ -885,6 +1072,21 @@ module Aws::WAF
     #
     #   * {Types::DeleteIPSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To delete an IP set
+    #
+    #   # The following example deletes an IP match set  with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.delete_ip_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     ip_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_ip_set({
@@ -981,6 +1183,21 @@ module Aws::WAF
     #
     #   * {Types::DeleteRuleResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To delete a rule
+    #
+    #   # The following example deletes a rule with the ID WAFRule-1-Example.
+    #
+    #   resp = client.delete_rule({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     rule_id: "WAFRule-1-Example", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_rule({
@@ -1031,6 +1248,21 @@ module Aws::WAF
     #
     #   * {Types::DeleteSizeConstraintSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To delete a size constraint set
+    #
+    #   # The following example deletes a size constraint set  with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.delete_size_constraint_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     size_constraint_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_size_constraint_set({
@@ -1081,6 +1313,21 @@ module Aws::WAF
     #
     #   * {Types::DeleteSqlInjectionMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To delete a SQL injection match set
+    #
+    #   # The following example deletes a SQL injection match set  with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.delete_sql_injection_match_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     sql_injection_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_sql_injection_match_set({
@@ -1125,6 +1372,21 @@ module Aws::WAF
     #
     #   * {Types::DeleteWebACLResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To delete a web ACL
+    #
+    #   # The following example deletes a web ACL with the ID example-46da-4444-5555-example.
+    #
+    #   resp = client.delete_web_acl({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     web_acl_id: "example-46da-4444-5555-example", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_web_acl({
@@ -1175,6 +1437,21 @@ module Aws::WAF
     #
     #   * {Types::DeleteXssMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To delete an XSS match set
+    #
+    #   # The following example deletes an XSS match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.delete_xss_match_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     xss_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_xss_match_set({
@@ -1206,6 +1483,34 @@ module Aws::WAF
     #
     #   * {Types::GetByteMatchSetResponse#byte_match_set #byte_match_set} => Types::ByteMatchSet
     #
+    #
+    # @example Example: To get a byte match set
+    #
+    #   # The following example returns the details of a byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.get_byte_match_set({
+    #     byte_match_set_id: "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     byte_match_set: {
+    #       byte_match_set_id: "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       byte_match_tuples: [
+    #         {
+    #           field_to_match: {
+    #             data: "referer", 
+    #             type: "HEADER", 
+    #           }, 
+    #           positional_constraint: "CONTAINS", 
+    #           target_string: "badrefer1", 
+    #           text_transformation: "NONE", 
+    #         }, 
+    #       ], 
+    #       name: "ByteMatchNameExample", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_byte_match_set({
@@ -1252,6 +1557,19 @@ module Aws::WAF
     #
     #   * {Types::GetChangeTokenResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To get a change token
+    #
+    #   # The following example returns a change token to use for a create, update or delete operation.
+    #
+    #   resp = client.get_change_token({
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Response structure
     #
     #   resp.change_token #=> String
@@ -1285,6 +1603,20 @@ module Aws::WAF
     #
     #   * {Types::GetChangeTokenStatusResponse#change_token_status #change_token_status} => String
     #
+    #
+    # @example Example: To get the change token status
+    #
+    #   # The following example returns the status of a change token with the ID abcd12f2-46da-4fdb-b8d5-fbd4c466928f.
+    #
+    #   resp = client.get_change_token_status({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token_status: "PENDING", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_change_token_status({
@@ -1314,6 +1646,29 @@ module Aws::WAF
     #
     #   * {Types::GetIPSetResponse#ip_set #ip_set} => Types::IPSet
     #
+    #
+    # @example Example: To get an IP set
+    #
+    #   # The following example returns the details of an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.get_ip_set({
+    #     ip_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     ip_set: {
+    #       ip_set_descriptors: [
+    #         {
+    #           type: "IPV4", 
+    #           value: "192.0.2.44/32", 
+    #         }, 
+    #       ], 
+    #       ip_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       name: "MyIPSetFriendlyName", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_ip_set({
@@ -1428,6 +1783,31 @@ module Aws::WAF
     #
     #   * {Types::GetRuleResponse#rule #rule} => Types::Rule
     #
+    #
+    # @example Example: To get a rule
+    #
+    #   # The following example returns the details of a rule with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.get_rule({
+    #     rule_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     rule: {
+    #       metric_name: "WAFByteHeaderRule", 
+    #       name: "WAFByteHeaderRule", 
+    #       predicates: [
+    #         {
+    #           data_id: "MyByteMatchSetID", 
+    #           negated: false, 
+    #           type: "ByteMatch", 
+    #         }, 
+    #       ], 
+    #       rule_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_rule({
@@ -1500,6 +1880,49 @@ module Aws::WAF
     #   * {Types::GetSampledRequestsResponse#population_size #population_size} => Integer
     #   * {Types::GetSampledRequestsResponse#time_window #time_window} => Types::TimeWindow
     #
+    #
+    # @example Example: To get a sampled requests
+    #
+    #   # The following example returns detailed information about 100 requests --a sample-- that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received between the time period 2016-09-27T15:50Z to 2016-09-27T15:50Z.
+    #
+    #   resp = client.get_sampled_requests({
+    #     max_items: 100, 
+    #     rule_id: "WAFRule-1-Example", 
+    #     time_window: {
+    #       end_time: Time.parse("2016-09-27T15:50Z"), 
+    #       start_time: Time.parse("2016-09-27T15:50Z"), 
+    #     }, 
+    #     web_acl_id: "createwebacl-1472061481310", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     population_size: 50, 
+    #     sampled_requests: [
+    #       {
+    #         action: "BLOCK", 
+    #         request: {
+    #           client_ip: "192.0.2.44", 
+    #           country: "US", 
+    #           http_version: "HTTP/1.1", 
+    #           headers: [
+    #             {
+    #               name: "User-Agent", 
+    #               value: "BadBot ", 
+    #             }, 
+    #           ], 
+    #           method: "HEAD", 
+    #         }, 
+    #         timestamp: Time.parse("2016-09-27T14:55Z"), 
+    #         weight: 1, 
+    #       }, 
+    #     ], 
+    #     time_window: {
+    #       end_time: Time.parse("2016-09-27T15:50Z"), 
+    #       start_time: Time.parse("2016-09-27T14:50Z"), 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_sampled_requests({
@@ -1550,6 +1973,33 @@ module Aws::WAF
     #
     #   * {Types::GetSizeConstraintSetResponse#size_constraint_set #size_constraint_set} => Types::SizeConstraintSet
     #
+    #
+    # @example Example: To get a size constraint set
+    #
+    #   # The following example returns the details of a size constraint match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.get_size_constraint_set({
+    #     size_constraint_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     size_constraint_set: {
+    #       name: "MySampleSizeConstraintSet", 
+    #       size_constraint_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       size_constraints: [
+    #         {
+    #           comparison_operator: "GT", 
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           size: 0, 
+    #           text_transformation: "NONE", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_size_constraint_set({
@@ -1588,6 +2038,31 @@ module Aws::WAF
     #
     #   * {Types::GetSqlInjectionMatchSetResponse#sql_injection_match_set #sql_injection_match_set} => Types::SqlInjectionMatchSet
     #
+    #
+    # @example Example: To get a SQL injection match set
+    #
+    #   # The following example returns the details of a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.get_sql_injection_match_set({
+    #     sql_injection_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     sql_injection_match_set: {
+    #       name: "MySQLInjectionMatchSet", 
+    #       sql_injection_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       sql_injection_match_tuples: [
+    #         {
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           text_transformation: "URL_DECODE", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_sql_injection_match_set({
@@ -1622,6 +2097,36 @@ module Aws::WAF
     #
     #   * {Types::GetWebACLResponse#web_acl #web_acl} => Types::WebACL
     #
+    #
+    # @example Example: To get a web ACL
+    #
+    #   # The following example returns the details of a web ACL with the ID createwebacl-1472061481310.
+    #
+    #   resp = client.get_web_acl({
+    #     web_acl_id: "createwebacl-1472061481310", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     web_acl: {
+    #       default_action: {
+    #         type: "ALLOW", 
+    #       }, 
+    #       metric_name: "CreateExample", 
+    #       name: "CreateExample", 
+    #       rules: [
+    #         {
+    #           action: {
+    #             type: "ALLOW", 
+    #           }, 
+    #           priority: 1, 
+    #           rule_id: "WAFRule-1-Example", 
+    #         }, 
+    #       ], 
+    #       web_acl_id: "createwebacl-1472061481310", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_web_acl({
@@ -1660,6 +2165,31 @@ module Aws::WAF
     #
     #   * {Types::GetXssMatchSetResponse#xss_match_set #xss_match_set} => Types::XssMatchSet
     #
+    #
+    # @example Example: To get an XSS match set
+    #
+    #   # The following example returns the details of an XSS match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.get_xss_match_set({
+    #     xss_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     xss_match_set: {
+    #       name: "MySampleXssMatchSet", 
+    #       xss_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       xss_match_tuples: [
+    #         {
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           text_transformation: "URL_DECODE", 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_xss_match_set({
@@ -1750,6 +2280,25 @@ module Aws::WAF
     #   * {Types::ListIPSetsResponse#next_marker #next_marker} => String
     #   * {Types::ListIPSetsResponse#ip_sets #ip_sets} => Array<Types::IPSetSummary>
     #
+    #
+    # @example Example: To list IP sets
+    #
+    #   # The following example returns an array of up to 100 IP match sets.
+    #
+    #   resp = client.list_ip_sets({
+    #     limit: 100, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     ip_sets: [
+    #       {
+    #         ip_set_id: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #         name: "MyIPSetFriendlyName", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_ip_sets({
@@ -1838,6 +2387,25 @@ module Aws::WAF
     #   * {Types::ListRulesResponse#next_marker #next_marker} => String
     #   * {Types::ListRulesResponse#rules #rules} => Array<Types::RuleSummary>
     #
+    #
+    # @example Example: To list rules
+    #
+    #   # The following example returns an array of up to 100 rules.
+    #
+    #   resp = client.list_rules({
+    #     limit: 100, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     rules: [
+    #       {
+    #         name: "WAFByteHeaderRule", 
+    #         rule_id: "WAFRule-1-Example", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_rules({
@@ -1884,6 +2452,25 @@ module Aws::WAF
     #   * {Types::ListSizeConstraintSetsResponse#next_marker #next_marker} => String
     #   * {Types::ListSizeConstraintSetsResponse#size_constraint_sets #size_constraint_sets} => Array<Types::SizeConstraintSetSummary>
     #
+    #
+    # @example Example: To list a size constraint sets
+    #
+    #   # The following example returns an array of up to 100 size contraint match sets.
+    #
+    #   resp = client.list_size_constraint_sets({
+    #     limit: 100, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     size_constraint_sets: [
+    #       {
+    #         name: "MySampleSizeConstraintSet", 
+    #         size_constraint_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_size_constraint_sets({
@@ -1930,6 +2517,25 @@ module Aws::WAF
     #   * {Types::ListSqlInjectionMatchSetsResponse#next_marker #next_marker} => String
     #   * {Types::ListSqlInjectionMatchSetsResponse#sql_injection_match_sets #sql_injection_match_sets} => Array<Types::SqlInjectionMatchSetSummary>
     #
+    #
+    # @example Example: To list SQL injection match sets
+    #
+    #   # The following example returns an array of up to 100 SQL injection match sets.
+    #
+    #   resp = client.list_sql_injection_match_sets({
+    #     limit: 100, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     sql_injection_match_sets: [
+    #       {
+    #         name: "MySQLInjectionMatchSet", 
+    #         sql_injection_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_sql_injection_match_sets({
@@ -1975,6 +2581,25 @@ module Aws::WAF
     #   * {Types::ListWebACLsResponse#next_marker #next_marker} => String
     #   * {Types::ListWebACLsResponse#web_acls #web_acls} => Array<Types::WebACLSummary>
     #
+    #
+    # @example Example: To list Web ACLs
+    #
+    #   # The following example returns an array of up to 100 web ACLs.
+    #
+    #   resp = client.list_web_acls({
+    #     limit: 100, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     web_acls: [
+    #       {
+    #         name: "WebACLexample", 
+    #         web_acl_id: "webacl-1472061481310", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_web_acls({
@@ -2019,6 +2644,25 @@ module Aws::WAF
     #   * {Types::ListXssMatchSetsResponse#next_marker #next_marker} => String
     #   * {Types::ListXssMatchSetsResponse#xss_match_sets #xss_match_sets} => Array<Types::XssMatchSetSummary>
     #
+    #
+    # @example Example: To list XSS match sets
+    #
+    #   # The following example returns an array of up to 100 XSS match sets.
+    #
+    #   resp = client.list_xss_match_sets({
+    #     limit: 100, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     xss_match_sets: [
+    #       {
+    #         name: "MySampleXssMatchSet", 
+    #         xss_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_xss_match_sets({
@@ -2111,6 +2755,35 @@ module Aws::WAF
     #
     #   * {Types::UpdateByteMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To update a byte match set
+    #
+    #   # The following example deletes a ByteMatchTuple object (filters) in an byte match set with the ID exampleIDs3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.update_byte_match_set({
+    #     byte_match_set_id: "exampleIDs3t-46da-4fdb-b8d5-abc321j569j5", 
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     updates: [
+    #       {
+    #         action: "DELETE", 
+    #         byte_match_tuple: {
+    #           field_to_match: {
+    #             data: "referer", 
+    #             type: "HEADER", 
+    #           }, 
+    #           positional_constraint: "CONTAINS", 
+    #           target_string: "badrefer1", 
+    #           text_transformation: "NONE", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_byte_match_set({
@@ -2223,6 +2896,30 @@ module Aws::WAF
     #
     #   * {Types::UpdateIPSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To update an IP set
+    #
+    #   # The following example deletes an IPSetDescriptor object in an IP match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.update_ip_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     ip_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #     updates: [
+    #       {
+    #         action: "DELETE", 
+    #         ip_set_descriptor: {
+    #           type: "IPV4", 
+    #           value: "192.0.2.44/32", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_ip_set({
@@ -2411,6 +3108,31 @@ module Aws::WAF
     #
     #   * {Types::UpdateRuleResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To update a rule
+    #
+    #   # The following example deletes a Predicate object in a rule with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.update_rule({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     rule_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #     updates: [
+    #       {
+    #         action: "DELETE", 
+    #         predicate: {
+    #           data_id: "MyByteMatchSetID", 
+    #           negated: false, 
+    #           type: "ByteMatch", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_rule({
@@ -2517,6 +3239,34 @@ module Aws::WAF
     #
     #   * {Types::UpdateSizeConstraintSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To update a size constraint set
+    #
+    #   # The following example deletes a SizeConstraint object (filters) in a size constraint set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.update_size_constraint_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     size_constraint_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #     updates: [
+    #       {
+    #         action: "DELETE", 
+    #         size_constraint: {
+    #           comparison_operator: "GT", 
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           size: 0, 
+    #           text_transformation: "NONE", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_size_constraint_set({
@@ -2618,6 +3368,32 @@ module Aws::WAF
     #
     #   * {Types::UpdateSqlInjectionMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To update a SQL injection match set
+    #
+    #   # The following example deletes a SqlInjectionMatchTuple object (filters) in a SQL injection match set with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.update_sql_injection_match_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     sql_injection_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #     updates: [
+    #       {
+    #         action: "DELETE", 
+    #         sql_injection_match_tuple: {
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           text_transformation: "URL_DECODE", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_sql_injection_match_set({
@@ -2736,6 +3512,36 @@ module Aws::WAF
     #
     #   * {Types::UpdateWebACLResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To update a Web ACL
+    #
+    #   # The following example deletes an ActivatedRule object in a WebACL with the ID webacl-1472061481310.
+    #
+    #   resp = client.update_web_acl({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     default_action: {
+    #       type: "ALLOW", 
+    #     }, 
+    #     updates: [
+    #       {
+    #         action: "DELETE", 
+    #         activated_rule: {
+    #           action: {
+    #             type: "ALLOW", 
+    #           }, 
+    #           priority: 1, 
+    #           rule_id: "WAFRule-1-Example", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #     web_acl_id: "webacl-1472061481310", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_web_acl({
@@ -2835,6 +3641,32 @@ module Aws::WAF
     #
     #   * {Types::UpdateXssMatchSetResponse#change_token #change_token} => String
     #
+    #
+    # @example Example: To update an XSS match set
+    #
+    #   # The following example deletes an XssMatchTuple object (filters) in an XssMatchSet with the ID example1ds3t-46da-4fdb-b8d5-abc321j569j5.
+    #
+    #   resp = client.update_xss_match_set({
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #     updates: [
+    #       {
+    #         action: "DELETE", 
+    #         xss_match_tuple: {
+    #           field_to_match: {
+    #             type: "QUERY_STRING", 
+    #           }, 
+    #           text_transformation: "URL_DECODE", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #     xss_match_set_id: "example1ds3t-46da-4fdb-b8d5-abc321j569j5", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     change_token: "abcd12f2-46da-4fdb-b8d5-fbd4c466928f", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_xss_match_set({
@@ -2880,7 +3712,7 @@ module Aws::WAF
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-waf'
-      context[:gem_version] = '1.0.0.rc8'
+      context[:gem_version] = '1.0.0.rc9'
       Seahorse::Client::Request.new(handlers, context)
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-waf
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc8
+  version: 1.0.0.rc9
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-06-26 00:00:00.000000000 Z
+date: 2017-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc13
+        version: 3.0.0.rc14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc13
+        version: 3.0.0.rc14
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement