aws-sdk-wafv2 1.50.0 → 1.51.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -63,7 +63,8 @@ module Aws::WAFV2
63
63
  # The inspection level to use for the Bot Control rule group. The
64
64
  # common level is the least expensive. The targeted level includes all
65
65
  # common level rules and adds rules with more advanced inspection
66
- # criteria. For details, see [WAF Bot Control rule group][1].
66
+ # criteria. For details, see [WAF Bot Control rule group][1] in the
67
+ # *WAF Developer Guide*.
67
68
  #
68
69
  #
69
70
  #
@@ -137,13 +138,12 @@ module Aws::WAFV2
137
138
  # Defines custom handling for the web request.
138
139
  #
139
140
  # For information about customizing web requests and responses, see
140
- # [Customizing web requests and responses in WAF][1] in the [WAF
141
- # Developer Guide][2].
141
+ # [Customizing web requests and responses in WAF][1] in the *WAF
142
+ # Developer Guide*.
142
143
  #
143
144
  #
144
145
  #
145
146
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
146
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
147
147
  # @return [Types::CustomRequestHandling]
148
148
  #
149
149
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/AllowAction AWS API Documentation
@@ -183,20 +183,22 @@ module Aws::WAFV2
183
183
  # The ARN must be in one of the following formats:
184
184
  #
185
185
  # * For an Application Load Balancer:
186
- # `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
186
+ # `arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
187
187
  # `
188
188
  #
189
189
  # * For an Amazon API Gateway REST API:
190
- # `arn:aws:apigateway:region::/restapis/api-id/stages/stage-name `
190
+ # `arn:partition:apigateway:region::/restapis/api-id/stages/stage-name
191
+ # `
191
192
  #
192
193
  # * For an AppSync GraphQL API:
193
- # `arn:aws:appsync:region:account-id:apis/GraphQLApiId `
194
+ # `arn:partition:appsync:region:account-id:apis/GraphQLApiId `
194
195
  #
195
196
  # * For an Amazon Cognito user pool:
196
- # `arn:aws:cognito-idp:region:account-id:userpool/user-pool-id `
197
+ # `arn:partition:cognito-idp:region:account-id:userpool/user-pool-id
198
+ # `
197
199
  #
198
200
  # * For an App Runner service:
199
- # `arn:aws:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
201
+ # `arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
200
202
  # `
201
203
  # @return [String]
202
204
  #
@@ -213,6 +215,47 @@ module Aws::WAFV2
213
215
  #
214
216
  class AssociateWebACLResponse < Aws::EmptyStructure; end
215
217
 
218
+ # Specifies custom configurations for the associations between the web
219
+ # ACL and protected resources.
220
+ #
221
+ # Use this to customize the maximum size of the request body that your
222
+ # protected CloudFront distributions forward to WAF for inspection. The
223
+ # default is 16 KB (16,384 kilobytes).
224
+ #
225
+ # <note markdown="1"> You are charged additional fees when your protected resources forward
226
+ # body sizes that are larger than the default. For more information, see
227
+ # [WAF Pricing][1].
228
+ #
229
+ # </note>
230
+ #
231
+ #
232
+ #
233
+ # [1]: http://aws.amazon.com/waf/pricing/
234
+ #
235
+ # @!attribute [rw] request_body
236
+ # Customizes the maximum size of the request body that your protected
237
+ # CloudFront distributions forward to WAF for inspection. The default
238
+ # size is 16 KB (16,384 kilobytes).
239
+ #
240
+ # <note markdown="1"> You are charged additional fees when your protected resources
241
+ # forward body sizes that are larger than the default. For more
242
+ # information, see [WAF Pricing][1].
243
+ #
244
+ # </note>
245
+ #
246
+ #
247
+ #
248
+ # [1]: http://aws.amazon.com/waf/pricing/
249
+ # @return [Hash<String,Types::RequestBodyAssociatedResourceTypeConfig>]
250
+ #
251
+ # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/AssociationConfig AWS API Documentation
252
+ #
253
+ class AssociationConfig < Struct.new(
254
+ :request_body)
255
+ SENSITIVE = []
256
+ include Aws::Structure
257
+ end
258
+
216
259
  # Specifies that WAF should block the request and optionally defines
217
260
  # additional custom handling for the response to the web request.
218
261
  #
@@ -223,13 +266,12 @@ module Aws::WAFV2
223
266
  # Defines a custom response for the web request.
224
267
  #
225
268
  # For information about customizing web requests and responses, see
226
- # [Customizing web requests and responses in WAF][1] in the [WAF
227
- # Developer Guide][2].
269
+ # [Customizing web requests and responses in WAF][1] in the *WAF
270
+ # Developer Guide*.
228
271
  #
229
272
  #
230
273
  #
231
274
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
232
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
233
275
  # @return [Types::CustomResponse]
234
276
  #
235
277
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/BlockAction AWS API Documentation
@@ -248,10 +290,16 @@ module Aws::WAFV2
248
290
  #
249
291
  # @!attribute [rw] oversize_handling
250
292
  # What WAF should do if the body is larger than WAF can inspect. WAF
251
- # does not support inspecting the entire contents of the body of a web
252
- # request when the body exceeds 8 KB (8192 bytes). Only the first 8 KB
253
- # of the request body are forwarded to WAF by the underlying host
254
- # service.
293
+ # does not support inspecting the entire contents of the web request
294
+ # body if the body exceeds the limit for the resource type. If the
295
+ # body is larger than the limit, the underlying host service only
296
+ # forwards the contents that are below the limit to WAF for
297
+ # inspection.
298
+ #
299
+ # The default limit is 8 KB (8,192 kilobytes) for regional resources
300
+ # and 16 KB (16,384 kilobytes) for CloudFront distributions. For
301
+ # CloudFront distributions, you can increase the limit in the web ACL
302
+ # `AssociationConfig`, for additional processing fees.
255
303
  #
256
304
  # The options for oversize handling are the following:
257
305
  #
@@ -266,7 +314,7 @@ module Aws::WAFV2
266
314
  #
267
315
  # You can combine the `MATCH` or `NO_MATCH` settings for oversize
268
316
  # handling with your rule and web ACL action settings, so that you
269
- # block any request whose body is over 8 KB.
317
+ # block any request whose body is over the limit.
270
318
  #
271
319
  # Default: `CONTINUE`
272
320
  # @return [String]
@@ -292,12 +340,12 @@ module Aws::WAFV2
292
340
  # FieldToMatch. The maximum length of the value is 200 bytes.
293
341
  #
294
342
  # Valid values depend on the component that you specify for inspection
295
- # in `FieldToMatch`\:
343
+ # in `FieldToMatch`:
296
344
  #
297
- # * `Method`\: The HTTP method that you want WAF to search for. This
345
+ # * `Method`: The HTTP method that you want WAF to search for. This
298
346
  # indicates the type of operation specified in the request.
299
347
  #
300
- # * `UriPath`\: The value that you want WAF to search for in the URI
348
+ # * `UriPath`: The value that you want WAF to search for in the URI
301
349
  # path, for example, `/images/daily-ad.jpg`.
302
350
  #
303
351
  # If `SearchString` includes alphabetic characters A-Z and a-z, note
@@ -422,13 +470,12 @@ module Aws::WAFV2
422
470
  # unexpired.
423
471
  #
424
472
  # For information about customizing web requests and responses, see
425
- # [Customizing web requests and responses in WAF][1] in the [WAF
426
- # Developer Guide][2].
473
+ # [Customizing web requests and responses in WAF][1] in the *WAF
474
+ # Developer Guide*.
427
475
  #
428
476
  #
429
477
  #
430
478
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
431
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
432
479
  # @return [Types::CustomRequestHandling]
433
480
  #
434
481
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/CaptchaAction AWS API Documentation
@@ -531,13 +578,12 @@ module Aws::WAFV2
531
578
  # unexpired.
532
579
  #
533
580
  # For information about customizing web requests and responses, see
534
- # [Customizing web requests and responses in WAF][1] in the [WAF
535
- # Developer Guide][2].
581
+ # [Customizing web requests and responses in WAF][1] in the *WAF
582
+ # Developer Guide*.
536
583
  #
537
584
  #
538
585
  #
539
586
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
540
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
541
587
  # @return [Types::CustomRequestHandling]
542
588
  #
543
589
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/ChallengeAction AWS API Documentation
@@ -596,7 +642,7 @@ module Aws::WAFV2
596
642
  # Specifies whether this is for an Amazon CloudFront distribution or
597
643
  # for a regional application. A regional application can be an
598
644
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
599
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
645
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
600
646
  # service.
601
647
  #
602
648
  # To work with CloudFront, you must also specify the Region US East
@@ -756,13 +802,12 @@ module Aws::WAFV2
756
802
  # Defines custom handling for the web request.
757
803
  #
758
804
  # For information about customizing web requests and responses, see
759
- # [Customizing web requests and responses in WAF][1] in the [WAF
760
- # Developer Guide][2].
805
+ # [Customizing web requests and responses in WAF][1] in the *WAF
806
+ # Developer Guide*.
761
807
  #
762
808
  #
763
809
  #
764
810
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
765
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
766
811
  # @return [Types::CustomRequestHandling]
767
812
  #
768
813
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/CountAction AWS API Documentation
@@ -782,7 +827,7 @@ module Aws::WAFV2
782
827
  # Specifies whether this is for an Amazon CloudFront distribution or
783
828
  # for a regional application. A regional application can be an
784
829
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
785
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
830
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
786
831
  # service.
787
832
  #
788
833
  # To work with CloudFront, you must also specify the Region US East
@@ -889,7 +934,7 @@ module Aws::WAFV2
889
934
  # Specifies whether this is for an Amazon CloudFront distribution or
890
935
  # for a regional application. A regional application can be an
891
936
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
892
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
937
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
893
938
  # service.
894
939
  #
895
940
  # To work with CloudFront, you must also specify the Region US East
@@ -950,7 +995,7 @@ module Aws::WAFV2
950
995
  # Specifies whether this is for an Amazon CloudFront distribution or
951
996
  # for a regional application. A regional application can be an
952
997
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
953
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
998
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
954
999
  # service.
955
1000
  #
956
1001
  # To work with CloudFront, you must also specify the Region US East
@@ -976,8 +1021,13 @@ module Aws::WAFV2
976
1021
  # relative cost of each rule. Simple rules that cost little to run use
977
1022
  # fewer WCUs than more complex rules that use more processing power.
978
1023
  # Rule group capacity is fixed at creation, which helps users plan
979
- # their web ACL WCU usage when they use a rule group. The WCU limit
980
- # for web ACLs is 1,500.
1024
+ # their web ACL WCU usage when they use a rule group. For more
1025
+ # information, see [WAF web ACL capacity units (WCU)][1] in the *WAF
1026
+ # Developer Guide*.
1027
+ #
1028
+ #
1029
+ #
1030
+ # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html
981
1031
  # @return [Integer]
982
1032
  #
983
1033
  # @!attribute [rw] description
@@ -1007,18 +1057,17 @@ module Aws::WAFV2
1007
1057
  # the rules that you define in the rule group.
1008
1058
  #
1009
1059
  # For information about customizing web requests and responses, see
1010
- # [Customizing web requests and responses in WAF][1] in the [WAF
1011
- # Developer Guide][2].
1060
+ # [Customizing web requests and responses in WAF][1] in the *WAF
1061
+ # Developer Guide*.
1012
1062
  #
1013
1063
  # For information about the limits on count and size for custom
1014
- # request and response settings, see [WAF quotas][3] in the [WAF
1015
- # Developer Guide][2].
1064
+ # request and response settings, see [WAF quotas][2] in the *WAF
1065
+ # Developer Guide*.
1016
1066
  #
1017
1067
  #
1018
1068
  #
1019
1069
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
1020
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1021
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1070
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1022
1071
  # @return [Hash<String,Types::CustomResponseBody>]
1023
1072
  #
1024
1073
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/CreateRuleGroupRequest AWS API Documentation
@@ -1061,7 +1110,7 @@ module Aws::WAFV2
1061
1110
  # Specifies whether this is for an Amazon CloudFront distribution or
1062
1111
  # for a regional application. A regional application can be an
1063
1112
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
1064
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
1113
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
1065
1114
  # service.
1066
1115
  #
1067
1116
  # To work with CloudFront, you must also specify the Region US East
@@ -1105,18 +1154,17 @@ module Aws::WAFV2
1105
1154
  # rules and default actions that you define in the web ACL.
1106
1155
  #
1107
1156
  # For information about customizing web requests and responses, see
1108
- # [Customizing web requests and responses in WAF][1] in the [WAF
1109
- # Developer Guide][2].
1157
+ # [Customizing web requests and responses in WAF][1] in the *WAF
1158
+ # Developer Guide*.
1110
1159
  #
1111
1160
  # For information about the limits on count and size for custom
1112
- # request and response settings, see [WAF quotas][3] in the [WAF
1113
- # Developer Guide][2].
1161
+ # request and response settings, see [WAF quotas][2] in the *WAF
1162
+ # Developer Guide*.
1114
1163
  #
1115
1164
  #
1116
1165
  #
1117
1166
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
1118
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1119
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1167
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1120
1168
  # @return [Hash<String,Types::CustomResponseBody>]
1121
1169
  #
1122
1170
  # @!attribute [rw] captcha_config
@@ -1148,6 +1196,25 @@ module Aws::WAFV2
1148
1196
  # `usa.gov` or `co.uk` as token domains.
1149
1197
  # @return [Array<String>]
1150
1198
  #
1199
+ # @!attribute [rw] association_config
1200
+ # Specifies custom configurations for the associations between the web
1201
+ # ACL and protected resources.
1202
+ #
1203
+ # Use this to customize the maximum size of the request body that your
1204
+ # protected CloudFront distributions forward to WAF for inspection.
1205
+ # The default is 16 KB (16,384 kilobytes).
1206
+ #
1207
+ # <note markdown="1"> You are charged additional fees when your protected resources
1208
+ # forward body sizes that are larger than the default. For more
1209
+ # information, see [WAF Pricing][1].
1210
+ #
1211
+ # </note>
1212
+ #
1213
+ #
1214
+ #
1215
+ # [1]: http://aws.amazon.com/waf/pricing/
1216
+ # @return [Types::AssociationConfig]
1217
+ #
1151
1218
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/CreateWebACLRequest AWS API Documentation
1152
1219
  #
1153
1220
  class CreateWebACLRequest < Struct.new(
@@ -1161,7 +1228,8 @@ module Aws::WAFV2
1161
1228
  :custom_response_bodies,
1162
1229
  :captcha_config,
1163
1230
  :challenge_config,
1164
- :token_domains)
1231
+ :token_domains,
1232
+ :association_config)
1165
1233
  SENSITIVE = []
1166
1234
  include Aws::Structure
1167
1235
  end
@@ -1213,26 +1281,24 @@ module Aws::WAFV2
1213
1281
  # `CaptchaAction` for requests with valid t okens, and `AllowAction`.
1214
1282
  #
1215
1283
  # For information about customizing web requests and responses, see
1216
- # [Customizing web requests and responses in WAF][1] in the [WAF
1217
- # Developer Guide][2].
1284
+ # [Customizing web requests and responses in WAF][1] in the *WAF
1285
+ # Developer Guide*.
1218
1286
  #
1219
1287
  #
1220
1288
  #
1221
1289
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
1222
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1223
1290
  #
1224
1291
  # @!attribute [rw] insert_headers
1225
1292
  # The HTTP headers to insert into the request. Duplicate header names
1226
1293
  # are not allowed.
1227
1294
  #
1228
1295
  # For information about the limits on count and size for custom
1229
- # request and response settings, see [WAF quotas][1] in the [WAF
1230
- # Developer Guide][2].
1296
+ # request and response settings, see [WAF quotas][1] in the *WAF
1297
+ # Developer Guide*.
1231
1298
  #
1232
1299
  #
1233
1300
  #
1234
1301
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1235
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1236
1302
  # @return [Array<Types::CustomHTTPHeader>]
1237
1303
  #
1238
1304
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/CustomRequestHandling AWS API Documentation
@@ -1248,25 +1314,23 @@ module Aws::WAFV2
1248
1314
  # BlockAction.
1249
1315
  #
1250
1316
  # For information about customizing web requests and responses, see
1251
- # [Customizing web requests and responses in WAF][1] in the [WAF
1252
- # Developer Guide][2].
1317
+ # [Customizing web requests and responses in WAF][1] in the *WAF
1318
+ # Developer Guide*.
1253
1319
  #
1254
1320
  #
1255
1321
  #
1256
1322
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
1257
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1258
1323
  #
1259
1324
  # @!attribute [rw] response_code
1260
1325
  # The HTTP status code to return to the client.
1261
1326
  #
1262
1327
  # For a list of status codes that you can use in your custom
1263
1328
  # responses, see [Supported status codes for custom response][1] in
1264
- # the [WAF Developer Guide][2].
1329
+ # the *WAF Developer Guide*.
1265
1330
  #
1266
1331
  #
1267
1332
  #
1268
1333
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/customizing-the-response-status-codes.html
1269
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1270
1334
  # @return [Integer]
1271
1335
  #
1272
1336
  # @!attribute [rw] custom_response_body_key
@@ -1285,13 +1349,12 @@ module Aws::WAFV2
1285
1349
  # not allowed.
1286
1350
  #
1287
1351
  # For information about the limits on count and size for custom
1288
- # request and response settings, see [WAF quotas][1] in the [WAF
1289
- # Developer Guide][2].
1352
+ # request and response settings, see [WAF quotas][1] in the *WAF
1353
+ # Developer Guide*.
1290
1354
  #
1291
1355
  #
1292
1356
  #
1293
1357
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1294
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1295
1358
  # @return [Array<Types::CustomHTTPHeader>]
1296
1359
  #
1297
1360
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/CustomResponse AWS API Documentation
@@ -1319,13 +1382,12 @@ module Aws::WAFV2
1319
1382
  # must specify JSON content in the `ContentType` setting.
1320
1383
  #
1321
1384
  # For information about the limits on count and size for custom
1322
- # request and response settings, see [WAF quotas][1] in the [WAF
1323
- # Developer Guide][2].
1385
+ # request and response settings, see [WAF quotas][1] in the *WAF
1386
+ # Developer Guide*.
1324
1387
  #
1325
1388
  #
1326
1389
  #
1327
1390
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1328
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1329
1391
  # @return [String]
1330
1392
  #
1331
1393
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/CustomResponseBody AWS API Documentation
@@ -1412,7 +1474,7 @@ module Aws::WAFV2
1412
1474
  # Specifies whether this is for an Amazon CloudFront distribution or
1413
1475
  # for a regional application. A regional application can be an
1414
1476
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
1415
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
1477
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
1416
1478
  # service.
1417
1479
  #
1418
1480
  # To work with CloudFront, you must also specify the Region US East
@@ -1502,7 +1564,7 @@ module Aws::WAFV2
1502
1564
  # Specifies whether this is for an Amazon CloudFront distribution or
1503
1565
  # for a regional application. A regional application can be an
1504
1566
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
1505
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
1567
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
1506
1568
  # service.
1507
1569
  #
1508
1570
  # To work with CloudFront, you must also specify the Region US East
@@ -1556,7 +1618,7 @@ module Aws::WAFV2
1556
1618
  # Specifies whether this is for an Amazon CloudFront distribution or
1557
1619
  # for a regional application. A regional application can be an
1558
1620
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
1559
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
1621
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
1560
1622
  # service.
1561
1623
  #
1562
1624
  # To work with CloudFront, you must also specify the Region US East
@@ -1610,7 +1672,7 @@ module Aws::WAFV2
1610
1672
  # Specifies whether this is for an Amazon CloudFront distribution or
1611
1673
  # for a regional application. A regional application can be an
1612
1674
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
1613
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
1675
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
1614
1676
  # service.
1615
1677
  #
1616
1678
  # To work with CloudFront, you must also specify the Region US East
@@ -1669,7 +1731,7 @@ module Aws::WAFV2
1669
1731
  # Specifies whether this is for an Amazon CloudFront distribution or
1670
1732
  # for a regional application. A regional application can be an
1671
1733
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
1672
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
1734
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
1673
1735
  # service.
1674
1736
  #
1675
1737
  # To work with CloudFront, you must also specify the Region US East
@@ -1716,13 +1778,21 @@ module Aws::WAFV2
1716
1778
  # @return [String]
1717
1779
  #
1718
1780
  # @!attribute [rw] capacity
1719
- # The web ACL capacity units (WCUs) required for this rule group. WAF
1720
- # uses web ACL capacity units (WCU) to calculate and control the
1721
- # operating resources that are used to run your rules, rule groups,
1722
- # and web ACLs. WAF calculates capacity differently for each rule
1723
- # type, to reflect each rule's relative cost. Rule group capacity is
1724
- # fixed at creation, so users can plan their web ACL WCU usage when
1725
- # they use a rule group. The WCU limit for web ACLs is 1,500.
1781
+ # The web ACL capacity units (WCUs) required for this rule group.
1782
+ #
1783
+ # WAF uses WCUs to calculate and control the operating resources that
1784
+ # are used to run your rules, rule groups, and web ACLs. WAF
1785
+ # calculates capacity differently for each rule type, to reflect the
1786
+ # relative cost of each rule. Simple rules that cost little to run use
1787
+ # fewer WCUs than more complex rules that use more processing power.
1788
+ # Rule group capacity is fixed at creation, which helps users plan
1789
+ # their web ACL WCU usage when they use a rule group. For more
1790
+ # information, see [WAF web ACL capacity units (WCU)][1] in the *WAF
1791
+ # Developer Guide*.
1792
+ #
1793
+ #
1794
+ #
1795
+ # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html
1726
1796
  # @return [Integer]
1727
1797
  #
1728
1798
  # @!attribute [rw] rules
@@ -1735,7 +1805,7 @@ module Aws::WAFV2
1735
1805
  # * The syntax for the label namespace prefix for a managed rule group
1736
1806
  # is the following:
1737
1807
  #
1738
- # `awswaf:managed:<vendor>:<rule group name>`\:
1808
+ # `awswaf:managed:<vendor>:<rule group name>`:
1739
1809
  #
1740
1810
  # * When a rule with a label matches a web request, WAF adds the fully
1741
1811
  # qualified label to the request. A fully qualified label is made up
@@ -1779,20 +1849,22 @@ module Aws::WAFV2
1779
1849
  # The ARN must be in one of the following formats:
1780
1850
  #
1781
1851
  # * For an Application Load Balancer:
1782
- # `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
1852
+ # `arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
1783
1853
  # `
1784
1854
  #
1785
1855
  # * For an Amazon API Gateway REST API:
1786
- # `arn:aws:apigateway:region::/restapis/api-id/stages/stage-name `
1856
+ # `arn:partition:apigateway:region::/restapis/api-id/stages/stage-name
1857
+ # `
1787
1858
  #
1788
1859
  # * For an AppSync GraphQL API:
1789
- # `arn:aws:appsync:region:account-id:apis/GraphQLApiId `
1860
+ # `arn:partition:appsync:region:account-id:apis/GraphQLApiId `
1790
1861
  #
1791
1862
  # * For an Amazon Cognito user pool:
1792
- # `arn:aws:cognito-idp:region:account-id:userpool/user-pool-id `
1863
+ # `arn:partition:cognito-idp:region:account-id:userpool/user-pool-id
1864
+ # `
1793
1865
  #
1794
1866
  # * For an App Runner service:
1795
- # `arn:aws:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
1867
+ # `arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
1796
1868
  # `
1797
1869
  # @return [String]
1798
1870
  #
@@ -1882,10 +1954,15 @@ module Aws::WAFV2
1882
1954
  # contains any additional data that you want to send to your web
1883
1955
  # server as the HTTP request body, such as data from a form.
1884
1956
  #
1885
- # Only the first 8 KB (8192 bytes) of the request body are forwarded
1886
- # to WAF for inspection by the underlying host service. For
1887
- # information about how to handle oversized request bodies, see the
1888
- # `Body` object configuration.
1957
+ # A limited amount of the request body is forwarded to WAF for
1958
+ # inspection by the underlying host service. For regional resources,
1959
+ # the limit is 8 KB (8,192 kilobytes) and for CloudFront
1960
+ # distributions, the limit is 16 KB (16,384 kilobytes). For CloudFront
1961
+ # distributions, you can increase the limit in the web ACL's
1962
+ # `AssociationConfig`, for additional processing fees.
1963
+ #
1964
+ # For information about how to handle oversized request bodies, see
1965
+ # the `Body` object configuration.
1889
1966
  # @return [Types::Body]
1890
1967
  #
1891
1968
  # @!attribute [rw] method
@@ -1899,10 +1976,15 @@ module Aws::WAFV2
1899
1976
  # contains any additional data that you want to send to your web
1900
1977
  # server as the HTTP request body, such as data from a form.
1901
1978
  #
1902
- # Only the first 8 KB (8192 bytes) of the request body are forwarded
1903
- # to WAF for inspection by the underlying host service. For
1904
- # information about how to handle oversized request bodies, see the
1905
- # `JsonBody` object configuration.
1979
+ # A limited amount of the request body is forwarded to WAF for
1980
+ # inspection by the underlying host service. For regional resources,
1981
+ # the limit is 8 KB (8,192 kilobytes) and for CloudFront
1982
+ # distributions, the limit is 16 KB (16,384 kilobytes). For CloudFront
1983
+ # distributions, you can increase the limit in the web ACL's
1984
+ # `AssociationConfig`, for additional processing fees.
1985
+ #
1986
+ # For information about how to handle oversized request bodies, see
1987
+ # the `JsonBody` object configuration.
1906
1988
  # @return [Types::JsonBody]
1907
1989
  #
1908
1990
  # @!attribute [rw] headers
@@ -2033,40 +2115,19 @@ module Aws::WAFV2
2033
2115
  end
2034
2116
 
2035
2117
  # The processing guidance for an Firewall Manager rule. This is like a
2036
- # regular rule Statement, but it can only contain a rule group
2118
+ # regular rule Statement, but it can only contain a single rule group
2037
2119
  # reference.
2038
2120
  #
2039
2121
  # @!attribute [rw] managed_rule_group_statement
2040
- # A rule statement used to run the rules that are defined in a managed
2041
- # rule group. To use this, provide the vendor name and the name of the
2042
- # rule group in this statement. You can retrieve the required names by
2043
- # calling ListAvailableManagedRuleGroups.
2044
- #
2045
- # You cannot nest a `ManagedRuleGroupStatement`, for example for use
2046
- # inside a `NotStatement` or `OrStatement`. It can only be referenced
2047
- # as a top-level statement within a rule.
2048
- #
2049
- # <note markdown="1"> You are charged additional fees when you use the WAF Bot Control
2050
- # managed rule group `AWSManagedRulesBotControlRuleSet` or the WAF
2051
- # Fraud Control account takeover prevention (ATP) managed rule group
2052
- # `AWSManagedRulesATPRuleSet`. For more information, see [WAF
2053
- # Pricing][1].
2054
- #
2055
- # </note>
2056
- #
2057
- #
2058
- #
2059
- # [1]: http://aws.amazon.com/waf/pricing/
2122
+ # A statement used by Firewall Manager to run the rules that are
2123
+ # defined in a managed rule group. This is managed by Firewall Manager
2124
+ # for an Firewall Manager WAF policy.
2060
2125
  # @return [Types::ManagedRuleGroupStatement]
2061
2126
  #
2062
2127
  # @!attribute [rw] rule_group_reference_statement
2063
- # A rule statement used to run the rules that are defined in a
2064
- # RuleGroup. To use this, create a rule group with your rules, then
2065
- # provide the ARN of the rule group in this statement.
2066
- #
2067
- # You cannot nest a `RuleGroupReferenceStatement`, for example for use
2068
- # inside a `NotStatement` or `OrStatement`. You can only use a rule
2069
- # group reference statement at the top level inside a web ACL.
2128
+ # A statement used by Firewall Manager to run the rules that are
2129
+ # defined in a rule group. This is managed by Firewall Manager for an
2130
+ # Firewall Manager WAF policy.
2070
2131
  # @return [Types::RuleGroupReferenceStatement]
2071
2132
  #
2072
2133
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/FirewallManagerStatement AWS API Documentation
@@ -2243,7 +2304,7 @@ module Aws::WAFV2
2243
2304
  # Specifies whether this is for an Amazon CloudFront distribution or
2244
2305
  # for a regional application. A regional application can be an
2245
2306
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
2246
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
2307
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
2247
2308
  # service.
2248
2309
  #
2249
2310
  # To work with CloudFront, you must also specify the Region US East
@@ -2332,7 +2393,7 @@ module Aws::WAFV2
2332
2393
  # Specifies whether this is for an Amazon CloudFront distribution or
2333
2394
  # for a regional application. A regional application can be an
2334
2395
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
2335
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
2396
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
2336
2397
  # service.
2337
2398
  #
2338
2399
  # To work with CloudFront, you must also specify the Region US East
@@ -2445,7 +2506,7 @@ module Aws::WAFV2
2445
2506
  # Specifies whether this is for an Amazon CloudFront distribution or
2446
2507
  # for a regional application. A regional application can be an
2447
2508
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
2448
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
2509
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
2449
2510
  # service.
2450
2511
  #
2451
2512
  # To work with CloudFront, you must also specify the Region US East
@@ -2519,7 +2580,7 @@ module Aws::WAFV2
2519
2580
  # Specifies whether this is for an Amazon CloudFront distribution or
2520
2581
  # for a regional application. A regional application can be an
2521
2582
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
2522
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
2583
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
2523
2584
  # service.
2524
2585
  #
2525
2586
  # To work with CloudFront, you must also specify the Region US East
@@ -2580,7 +2641,7 @@ module Aws::WAFV2
2580
2641
  # Specifies whether this is for an Amazon CloudFront distribution or
2581
2642
  # for a regional application. A regional application can be an
2582
2643
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
2583
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
2644
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
2584
2645
  # service.
2585
2646
  #
2586
2647
  # To work with CloudFront, you must also specify the Region US East
@@ -2651,7 +2712,7 @@ module Aws::WAFV2
2651
2712
  # Specifies whether this is for an Amazon CloudFront distribution or
2652
2713
  # for a regional application. A regional application can be an
2653
2714
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
2654
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
2715
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
2655
2716
  # service.
2656
2717
  #
2657
2718
  # To work with CloudFront, you must also specify the Region US East
@@ -2731,20 +2792,22 @@ module Aws::WAFV2
2731
2792
  # The ARN must be in one of the following formats:
2732
2793
  #
2733
2794
  # * For an Application Load Balancer:
2734
- # `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
2795
+ # `arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
2735
2796
  # `
2736
2797
  #
2737
2798
  # * For an Amazon API Gateway REST API:
2738
- # `arn:aws:apigateway:region::/restapis/api-id/stages/stage-name `
2799
+ # `arn:partition:apigateway:region::/restapis/api-id/stages/stage-name
2800
+ # `
2739
2801
  #
2740
2802
  # * For an AppSync GraphQL API:
2741
- # `arn:aws:appsync:region:account-id:apis/GraphQLApiId `
2803
+ # `arn:partition:appsync:region:account-id:apis/GraphQLApiId `
2742
2804
  #
2743
2805
  # * For an Amazon Cognito user pool:
2744
- # `arn:aws:cognito-idp:region:account-id:userpool/user-pool-id `
2806
+ # `arn:partition:cognito-idp:region:account-id:userpool/user-pool-id
2807
+ # `
2745
2808
  #
2746
2809
  # * For an App Runner service:
2747
- # `arn:aws:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
2810
+ # `arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
2748
2811
  # `
2749
2812
  # @return [String]
2750
2813
  #
@@ -2778,7 +2841,7 @@ module Aws::WAFV2
2778
2841
  # Specifies whether this is for an Amazon CloudFront distribution or
2779
2842
  # for a regional application. A regional application can be an
2780
2843
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
2781
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
2844
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
2782
2845
  # service.
2783
2846
  #
2784
2847
  # To work with CloudFront, you must also specify the Region US East
@@ -3347,10 +3410,16 @@ module Aws::WAFV2
3347
3410
  #
3348
3411
  # @!attribute [rw] oversize_handling
3349
3412
  # What WAF should do if the body is larger than WAF can inspect. WAF
3350
- # does not support inspecting the entire contents of the body of a web
3351
- # request when the body exceeds 8 KB (8192 bytes). Only the first 8 KB
3352
- # of the request body are forwarded to WAF by the underlying host
3353
- # service.
3413
+ # does not support inspecting the entire contents of the web request
3414
+ # body if the body exceeds the limit for the resource type. If the
3415
+ # body is larger than the limit, the underlying host service only
3416
+ # forwards the contents that are below the limit to WAF for
3417
+ # inspection.
3418
+ #
3419
+ # The default limit is 8 KB (8,192 kilobytes) for regional resources
3420
+ # and 16 KB (16,384 kilobytes) for CloudFront distributions. For
3421
+ # CloudFront distributions, you can increase the limit in the web ACL
3422
+ # `AssociationConfig`, for additional processing fees.
3354
3423
  #
3355
3424
  # The options for oversize handling are the following:
3356
3425
  #
@@ -3365,7 +3434,7 @@ module Aws::WAFV2
3365
3434
  #
3366
3435
  # You can combine the `MATCH` or `NO_MATCH` settings for oversize
3367
3436
  # handling with your rule and web ACL action settings, so that you
3368
- # block any request whose body is over 8 KB.
3437
+ # block any request whose body is over the limit.
3369
3438
  #
3370
3439
  # Default: `CONTINUE`
3371
3440
  # @return [String]
@@ -3537,7 +3606,7 @@ module Aws::WAFV2
3537
3606
  # Specifies whether this is for an Amazon CloudFront distribution or
3538
3607
  # for a regional application. A regional application can be an
3539
3608
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
3540
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
3609
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
3541
3610
  # service.
3542
3611
  #
3543
3612
  # To work with CloudFront, you must also specify the Region US East
@@ -3607,7 +3676,7 @@ module Aws::WAFV2
3607
3676
  # Specifies whether this is for an Amazon CloudFront distribution or
3608
3677
  # for a regional application. A regional application can be an
3609
3678
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
3610
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
3679
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
3611
3680
  # service.
3612
3681
  #
3613
3682
  # To work with CloudFront, you must also specify the Region US East
@@ -3668,7 +3737,7 @@ module Aws::WAFV2
3668
3737
  # Specifies whether this is for an Amazon CloudFront distribution or
3669
3738
  # for a regional application. A regional application can be an
3670
3739
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
3671
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
3740
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
3672
3741
  # service.
3673
3742
  #
3674
3743
  # To work with CloudFront, you must also specify the Region US East
@@ -3731,7 +3800,7 @@ module Aws::WAFV2
3731
3800
  # Specifies whether this is for an Amazon CloudFront distribution or
3732
3801
  # for a regional application. A regional application can be an
3733
3802
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
3734
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
3803
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
3735
3804
  # service.
3736
3805
  #
3737
3806
  # To work with CloudFront, you must also specify the Region US East
@@ -3792,7 +3861,7 @@ module Aws::WAFV2
3792
3861
  # Specifies whether this is for an Amazon CloudFront distribution or
3793
3862
  # for a regional application. A regional application can be an
3794
3863
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
3795
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
3864
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
3796
3865
  # service.
3797
3866
  #
3798
3867
  # To work with CloudFront, you must also specify the Region US East
@@ -3904,7 +3973,7 @@ module Aws::WAFV2
3904
3973
  # Specifies whether this is for an Amazon CloudFront distribution or
3905
3974
  # for a regional application. A regional application can be an
3906
3975
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
3907
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
3976
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
3908
3977
  # service.
3909
3978
  #
3910
3979
  # To work with CloudFront, you must also specify the Region US East
@@ -3968,7 +4037,7 @@ module Aws::WAFV2
3968
4037
  # @!attribute [rw] resource_type
3969
4038
  # Used for web ACLs that are scoped for regional applications. A
3970
4039
  # regional application can be an Application Load Balancer (ALB), an
3971
- # Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon
4040
+ # Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon
3972
4041
  # Cognito user pool, or an App Runner service.
3973
4042
  #
3974
4043
  # <note markdown="1"> If you don't provide a resource type, the call uses the resource
@@ -4005,7 +4074,7 @@ module Aws::WAFV2
4005
4074
  # Specifies whether this is for an Amazon CloudFront distribution or
4006
4075
  # for a regional application. A regional application can be an
4007
4076
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
4008
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
4077
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
4009
4078
  # service.
4010
4079
  #
4011
4080
  # To work with CloudFront, you must also specify the Region US East
@@ -4116,7 +4185,7 @@ module Aws::WAFV2
4116
4185
  # Specifies whether this is for an Amazon CloudFront distribution or
4117
4186
  # for a regional application. A regional application can be an
4118
4187
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
4119
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
4188
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
4120
4189
  # service.
4121
4190
  #
4122
4191
  # To work with CloudFront, you must also specify the Region US East
@@ -4592,7 +4661,7 @@ module Aws::WAFV2
4592
4661
  # * The syntax for the label namespace prefix for a managed rule group
4593
4662
  # is the following:
4594
4663
  #
4595
- # `awswaf:managed:<vendor>:<rule group name>`\:
4664
+ # `awswaf:managed:<vendor>:<rule group name>`:
4596
4665
  #
4597
4666
  # * When a rule with a label matches a web request, WAF adds the fully
4598
4667
  # qualified label to the request. A fully qualified label is made up
@@ -4671,7 +4740,7 @@ module Aws::WAFV2
4671
4740
  # * The syntax for the label namespace prefix for a managed rule group
4672
4741
  # is the following:
4673
4742
  #
4674
- # `awswaf:managed:<vendor>:<rule group name>`\:
4743
+ # `awswaf:managed:<vendor>:<rule group name>`:
4675
4744
  #
4676
4745
  # * When a rule with a label matches a web request, WAF adds the fully
4677
4746
  # qualified label to the request. A fully qualified label is made up
@@ -4721,8 +4790,13 @@ module Aws::WAFV2
4721
4790
  # relative cost of each rule. Simple rules that cost little to run use
4722
4791
  # fewer WCUs than more complex rules that use more processing power.
4723
4792
  # Rule group capacity is fixed at creation, which helps users plan
4724
- # their web ACL WCU usage when they use a rule group. The WCU limit
4725
- # for web ACLs is 1,500.
4793
+ # their web ACL WCU usage when they use a rule group. For more
4794
+ # information, see [WAF web ACL capacity units (WCU)][1] in the *WAF
4795
+ # Developer Guide*.
4796
+ #
4797
+ #
4798
+ #
4799
+ # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html
4726
4800
  # @return [Integer]
4727
4801
  #
4728
4802
  # @!attribute [rw] forecasted_lifetime
@@ -4960,7 +5034,7 @@ module Aws::WAFV2
4960
5034
  # Specifies whether this is for an Amazon CloudFront distribution or
4961
5035
  # for a regional application. A regional application can be an
4962
5036
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
4963
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
5037
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
4964
5038
  # service.
4965
5039
  #
4966
5040
  # To work with CloudFront, you must also specify the Region US East
@@ -5043,8 +5117,7 @@ module Aws::WAFV2
5043
5117
  #
5044
5118
  # The policy specifications must conform to the following:
5045
5119
  #
5046
- # * The policy must be composed using IAM Policy version 2012-10-17 or
5047
- # version 2015-01-01.
5120
+ # * The policy must be composed using IAM Policy version 2012-10-17.
5048
5121
  #
5049
5122
  # * The policy must include specifications for `Effect`, `Action`, and
5050
5123
  # `Principal`.
@@ -5399,6 +5472,39 @@ module Aws::WAFV2
5399
5472
  include Aws::Structure
5400
5473
  end
5401
5474
 
5475
+ # Customizes the maximum size of the request body that your protected
5476
+ # CloudFront distributions forward to WAF for inspection. The default
5477
+ # size is 16 KB (16,384 kilobytes).
5478
+ #
5479
+ # <note markdown="1"> You are charged additional fees when your protected resources forward
5480
+ # body sizes that are larger than the default. For more information, see
5481
+ # [WAF Pricing][1].
5482
+ #
5483
+ # </note>
5484
+ #
5485
+ # This is used in the `AssociationConfig` of the web ACL.
5486
+ #
5487
+ #
5488
+ #
5489
+ # [1]: http://aws.amazon.com/waf/pricing/
5490
+ #
5491
+ # @!attribute [rw] default_size_inspection_limit
5492
+ # Specifies the maximum size of the web request body component that an
5493
+ # associated CloudFront distribution should send to WAF for
5494
+ # inspection. This applies to statements in the web ACL that inspect
5495
+ # the body or JSON body.
5496
+ #
5497
+ # Default: `16 KB (16,384 kilobytes)`
5498
+ # @return [String]
5499
+ #
5500
+ # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/RequestBodyAssociatedResourceTypeConfig AWS API Documentation
5501
+ #
5502
+ class RequestBodyAssociatedResourceTypeConfig < Struct.new(
5503
+ :default_size_inspection_limit)
5504
+ SENSITIVE = []
5505
+ include Aws::Structure
5506
+ end
5507
+
5402
5508
  # The criteria for inspecting login requests, used by the ATP rule group
5403
5509
  # to validate credentials usage.
5404
5510
  #
@@ -5905,8 +6011,13 @@ module Aws::WAFV2
5905
6011
  # relative cost of each rule. Simple rules that cost little to run use
5906
6012
  # fewer WCUs than more complex rules that use more processing power.
5907
6013
  # Rule group capacity is fixed at creation, which helps users plan
5908
- # their web ACL WCU usage when they use a rule group. The WCU limit
5909
- # for web ACLs is 1,500.
6014
+ # their web ACL WCU usage when they use a rule group. For more
6015
+ # information, see [WAF web ACL capacity units (WCU)][1] in the *WAF
6016
+ # Developer Guide*.
6017
+ #
6018
+ #
6019
+ #
6020
+ # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html
5910
6021
  # @return [Integer]
5911
6022
  #
5912
6023
  # @!attribute [rw] arn
@@ -5953,18 +6064,17 @@ module Aws::WAFV2
5953
6064
  # the rules that you define in the rule group.
5954
6065
  #
5955
6066
  # For information about customizing web requests and responses, see
5956
- # [Customizing web requests and responses in WAF][1] in the [WAF
5957
- # Developer Guide][2].
6067
+ # [Customizing web requests and responses in WAF][1] in the *WAF
6068
+ # Developer Guide*.
5958
6069
  #
5959
6070
  # For information about the limits on count and size for custom
5960
- # request and response settings, see [WAF quotas][3] in the [WAF
5961
- # Developer Guide][2].
6071
+ # request and response settings, see [WAF quotas][2] in the *WAF
6072
+ # Developer Guide*.
5962
6073
  #
5963
6074
  #
5964
6075
  #
5965
6076
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
5966
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
5967
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
6077
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
5968
6078
  # @return [Hash<String,Types::CustomResponseBody>]
5969
6079
  #
5970
6080
  # @!attribute [rw] available_labels
@@ -6251,9 +6361,14 @@ module Aws::WAFV2
6251
6361
  # statement to look for query strings that are longer than 100 bytes.
6252
6362
  #
6253
6363
  # If you configure WAF to inspect the request body, WAF inspects only
6254
- # the first 8192 bytes (8 KB). If the request body for your web requests
6255
- # never exceeds 8192 bytes, you could use a size constraint statement to
6256
- # block requests that have a request body greater than 8192 bytes.
6364
+ # the number of bytes of the body up to the limit for the web ACL. By
6365
+ # default, for regional web ACLs, this limit is 8 KB (8,192 kilobytes)
6366
+ # and for CloudFront web ACLs, this limit is 16 KB (16,384 kilobytes).
6367
+ # For CloudFront web ACLs, you can increase the limit in the web ACL
6368
+ # `AssociationConfig`, for additional fees. If you know that the request
6369
+ # body for your web requests should never exceed the inspection limit,
6370
+ # you could use a size constraint statement to block requests that have
6371
+ # a larger request body size.
6257
6372
  #
6258
6373
  # If you choose URI for the value of Part of the request to filter on,
6259
6374
  # the slash (/) in the URI counts as one character. For example, the URI
@@ -6375,10 +6490,14 @@ module Aws::WAFV2
6375
6490
  # 100 bytes.
6376
6491
  #
6377
6492
  # If you configure WAF to inspect the request body, WAF inspects only
6378
- # the first 8192 bytes (8 KB). If the request body for your web
6379
- # requests never exceeds 8192 bytes, you could use a size constraint
6380
- # statement to block requests that have a request body greater than
6381
- # 8192 bytes.
6493
+ # the number of bytes of the body up to the limit for the web ACL. By
6494
+ # default, for regional web ACLs, this limit is 8 KB (8,192 kilobytes)
6495
+ # and for CloudFront web ACLs, this limit is 16 KB (16,384 kilobytes).
6496
+ # For CloudFront web ACLs, you can increase the limit in the web ACL
6497
+ # `AssociationConfig`, for additional fees. If you know that the
6498
+ # request body for your web requests should never exceed the
6499
+ # inspection limit, you could use a size constraint statement to block
6500
+ # requests that have a larger request body size.
6382
6501
  #
6383
6502
  # If you choose URI for the value of Part of the request to filter on,
6384
6503
  # the slash (/) in the URI counts as one character. For example, the
@@ -6893,7 +7012,7 @@ module Aws::WAFV2
6893
7012
  # Specifies whether this is for an Amazon CloudFront distribution or
6894
7013
  # for a regional application. A regional application can be an
6895
7014
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
6896
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
7015
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
6897
7016
  # service.
6898
7017
  #
6899
7018
  # To work with CloudFront, you must also specify the Region US East
@@ -7012,7 +7131,7 @@ module Aws::WAFV2
7012
7131
  # Specifies whether this is for an Amazon CloudFront distribution or
7013
7132
  # for a regional application. A regional application can be an
7014
7133
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
7015
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
7134
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
7016
7135
  # service.
7017
7136
  #
7018
7137
  # To work with CloudFront, you must also specify the Region US East
@@ -7111,7 +7230,7 @@ module Aws::WAFV2
7111
7230
  # Specifies whether this is for an Amazon CloudFront distribution or
7112
7231
  # for a regional application. A regional application can be an
7113
7232
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
7114
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
7233
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
7115
7234
  # service.
7116
7235
  #
7117
7236
  # To work with CloudFront, you must also specify the Region US East
@@ -7184,7 +7303,7 @@ module Aws::WAFV2
7184
7303
  # Specifies whether this is for an Amazon CloudFront distribution or
7185
7304
  # for a regional application. A regional application can be an
7186
7305
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
7187
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
7306
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
7188
7307
  # service.
7189
7308
  #
7190
7309
  # To work with CloudFront, you must also specify the Region US East
@@ -7237,18 +7356,17 @@ module Aws::WAFV2
7237
7356
  # the rules that you define in the rule group.
7238
7357
  #
7239
7358
  # For information about customizing web requests and responses, see
7240
- # [Customizing web requests and responses in WAF][1] in the [WAF
7241
- # Developer Guide][2].
7359
+ # [Customizing web requests and responses in WAF][1] in the *WAF
7360
+ # Developer Guide*.
7242
7361
  #
7243
7362
  # For information about the limits on count and size for custom
7244
- # request and response settings, see [WAF quotas][3] in the [WAF
7245
- # Developer Guide][2].
7363
+ # request and response settings, see [WAF quotas][2] in the *WAF
7364
+ # Developer Guide*.
7246
7365
  #
7247
7366
  #
7248
7367
  #
7249
7368
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
7250
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
7251
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
7369
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
7252
7370
  # @return [Hash<String,Types::CustomResponseBody>]
7253
7371
  #
7254
7372
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/UpdateRuleGroupRequest AWS API Documentation
@@ -7289,7 +7407,7 @@ module Aws::WAFV2
7289
7407
  # Specifies whether this is for an Amazon CloudFront distribution or
7290
7408
  # for a regional application. A regional application can be an
7291
7409
  # Application Load Balancer (ALB), an Amazon API Gateway REST API, an
7292
- # AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner
7410
+ # AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner
7293
7411
  # service.
7294
7412
  #
7295
7413
  # To work with CloudFront, you must also specify the Region US East
@@ -7347,18 +7465,17 @@ module Aws::WAFV2
7347
7465
  # rules and default actions that you define in the web ACL.
7348
7466
  #
7349
7467
  # For information about customizing web requests and responses, see
7350
- # [Customizing web requests and responses in WAF][1] in the [WAF
7351
- # Developer Guide][2].
7468
+ # [Customizing web requests and responses in WAF][1] in the *WAF
7469
+ # Developer Guide*.
7352
7470
  #
7353
7471
  # For information about the limits on count and size for custom
7354
- # request and response settings, see [WAF quotas][3] in the [WAF
7355
- # Developer Guide][2].
7472
+ # request and response settings, see [WAF quotas][2] in the *WAF
7473
+ # Developer Guide*.
7356
7474
  #
7357
7475
  #
7358
7476
  #
7359
7477
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
7360
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
7361
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
7478
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
7362
7479
  # @return [Hash<String,Types::CustomResponseBody>]
7363
7480
  #
7364
7481
  # @!attribute [rw] captcha_config
@@ -7390,6 +7507,25 @@ module Aws::WAFV2
7390
7507
  # `usa.gov` or `co.uk` as token domains.
7391
7508
  # @return [Array<String>]
7392
7509
  #
7510
+ # @!attribute [rw] association_config
7511
+ # Specifies custom configurations for the associations between the web
7512
+ # ACL and protected resources.
7513
+ #
7514
+ # Use this to customize the maximum size of the request body that your
7515
+ # protected CloudFront distributions forward to WAF for inspection.
7516
+ # The default is 16 KB (16,384 kilobytes).
7517
+ #
7518
+ # <note markdown="1"> You are charged additional fees when your protected resources
7519
+ # forward body sizes that are larger than the default. For more
7520
+ # information, see [WAF Pricing][1].
7521
+ #
7522
+ # </note>
7523
+ #
7524
+ #
7525
+ #
7526
+ # [1]: http://aws.amazon.com/waf/pricing/
7527
+ # @return [Types::AssociationConfig]
7528
+ #
7393
7529
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/UpdateWebACLRequest AWS API Documentation
7394
7530
  #
7395
7531
  class UpdateWebACLRequest < Struct.new(
@@ -7404,7 +7540,8 @@ module Aws::WAFV2
7404
7540
  :custom_response_bodies,
7405
7541
  :captcha_config,
7406
7542
  :challenge_config,
7407
- :token_domains)
7543
+ :token_domains,
7544
+ :association_config)
7408
7545
  SENSITIVE = []
7409
7546
  include Aws::Structure
7410
7547
  end
@@ -7499,7 +7636,7 @@ module Aws::WAFV2
7499
7636
  # @!attribute [rw] cloud_watch_metrics_enabled
7500
7637
  # A boolean indicating whether the associated resource sends metrics
7501
7638
  # to Amazon CloudWatch. For the list of available metrics, see [WAF
7502
- # Metrics][1].
7639
+ # Metrics][1] in the *WAF Developer Guide*.
7503
7640
  #
7504
7641
  #
7505
7642
  #
@@ -7665,8 +7802,7 @@ module Aws::WAFV2
7665
7802
  #
7666
7803
  # The policy specifications must conform to the following:
7667
7804
  #
7668
- # * The policy must be composed using IAM Policy version 2012-10-17 or
7669
- # version 2015-01-01.
7805
+ # * The policy must be composed using IAM Policy version 2012-10-17.
7670
7806
  #
7671
7807
  # * The policy must include specifications for `Effect`, `Action`, and
7672
7808
  # `Principal`.
@@ -7871,7 +8007,7 @@ module Aws::WAFV2
7871
8007
  # can associate a web ACL with one or more Amazon Web Services resources
7872
8008
  # to protect. The resources can be an Amazon CloudFront distribution, an
7873
8009
  # Amazon API Gateway REST API, an Application Load Balancer, an AppSync
7874
- # GraphQL API, Amazon Cognito user pool, or an App Runner service.
8010
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
7875
8011
  #
7876
8012
  # @!attribute [rw] name
7877
8013
  # The name of the web ACL. You cannot change the name of a web ACL
@@ -7920,8 +8056,13 @@ module Aws::WAFV2
7920
8056
  # relative cost of each rule. Simple rules that cost little to run use
7921
8057
  # fewer WCUs than more complex rules that use more processing power.
7922
8058
  # Rule group capacity is fixed at creation, which helps users plan
7923
- # their web ACL WCU usage when they use a rule group. The WCU limit
7924
- # for web ACLs is 1,500.
8059
+ # their web ACL WCU usage when they use a rule group. For more
8060
+ # information, see [WAF web ACL capacity units (WCU)][1] in the *WAF
8061
+ # Developer Guide*.
8062
+ #
8063
+ #
8064
+ #
8065
+ # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html
7925
8066
  # @return [Integer]
7926
8067
  #
7927
8068
  # @!attribute [rw] pre_process_firewall_manager_rule_groups
@@ -7980,18 +8121,17 @@ module Aws::WAFV2
7980
8121
  # rules and default actions that you define in the web ACL.
7981
8122
  #
7982
8123
  # For information about customizing web requests and responses, see
7983
- # [Customizing web requests and responses in WAF][1] in the [WAF
7984
- # Developer Guide][2].
8124
+ # [Customizing web requests and responses in WAF][1] in the *WAF
8125
+ # Developer Guide*.
7985
8126
  #
7986
8127
  # For information about the limits on count and size for custom
7987
- # request and response settings, see [WAF quotas][3] in the [WAF
7988
- # Developer Guide][2].
8128
+ # request and response settings, see [WAF quotas][2] in the *WAF
8129
+ # Developer Guide*.
7989
8130
  #
7990
8131
  #
7991
8132
  #
7992
8133
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
7993
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
7994
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
8134
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
7995
8135
  # @return [Hash<String,Types::CustomResponseBody>]
7996
8136
  #
7997
8137
  # @!attribute [rw] captcha_config
@@ -8017,6 +8157,25 @@ module Aws::WAFV2
8017
8157
  # domain list, including their prefixed subdomains.
8018
8158
  # @return [Array<String>]
8019
8159
  #
8160
+ # @!attribute [rw] association_config
8161
+ # Specifies custom configurations for the associations between the web
8162
+ # ACL and protected resources.
8163
+ #
8164
+ # Use this to customize the maximum size of the request body that your
8165
+ # protected CloudFront distributions forward to WAF for inspection.
8166
+ # The default is 16 KB (16,384 kilobytes).
8167
+ #
8168
+ # <note markdown="1"> You are charged additional fees when your protected resources
8169
+ # forward body sizes that are larger than the default. For more
8170
+ # information, see [WAF Pricing][1].
8171
+ #
8172
+ # </note>
8173
+ #
8174
+ #
8175
+ #
8176
+ # [1]: http://aws.amazon.com/waf/pricing/
8177
+ # @return [Types::AssociationConfig]
8178
+ #
8020
8179
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/WebACL AWS API Documentation
8021
8180
  #
8022
8181
  class WebACL < Struct.new(
@@ -8035,7 +8194,8 @@ module Aws::WAFV2
8035
8194
  :custom_response_bodies,
8036
8195
  :captcha_config,
8037
8196
  :challenge_config,
8038
- :token_domains)
8197
+ :token_domains,
8198
+ :association_config)
8039
8199
  SENSITIVE = []
8040
8200
  include Aws::Structure
8041
8201
  end