aws-sdk-wafv2 1.53.0 → 1.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -381,13 +381,13 @@ module Aws::WAFV2
381
381
  # Associates a web ACL with a regional application resource, to protect
382
382
  # the resource. A regional application can be an Application Load
383
383
  # Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL
384
- # API, a Amazon Cognito user pool, or an App Runner service.
384
+ # API, an Amazon Cognito user pool, or an App Runner service.
385
385
  #
386
386
  # For Amazon CloudFront, don't use this call. Instead, use your
387
387
  # CloudFront distribution configuration. To associate a web ACL, in the
388
388
  # CloudFront call `UpdateDistribution`, set the web ACL ID to the Amazon
389
389
  # Resource Name (ARN) of the web ACL. For information, see
390
- # [UpdateDistribution][1].
390
+ # [UpdateDistribution][1] in the *Amazon CloudFront Developer Guide*.
391
391
  #
392
392
  # When you make changes to web ACLs or web ACL components, like rules
393
393
  # and rule groups, WAF propagates the changes everywhere that the web
@@ -418,20 +418,21 @@ module Aws::WAFV2
418
418
  # The ARN must be in one of the following formats:
419
419
  #
420
420
  # * For an Application Load Balancer:
421
- # `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
421
+ # `arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
422
422
  # `
423
423
  #
424
424
  # * For an Amazon API Gateway REST API:
425
- # `arn:aws:apigateway:region::/restapis/api-id/stages/stage-name `
425
+ # `arn:partition:apigateway:region::/restapis/api-id/stages/stage-name
426
+ # `
426
427
  #
427
428
  # * For an AppSync GraphQL API:
428
- # `arn:aws:appsync:region:account-id:apis/GraphQLApiId `
429
+ # `arn:partition:appsync:region:account-id:apis/GraphQLApiId `
429
430
  #
430
431
  # * For an Amazon Cognito user pool:
431
- # `arn:aws:cognito-idp:region:account-id:userpool/user-pool-id `
432
+ # `arn:partition:cognito-idp:region:account-id:userpool/user-pool-id `
432
433
  #
433
434
  # * For an App Runner service:
434
- # `arn:aws:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
435
+ # `arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
435
436
  # `
436
437
  #
437
438
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -462,13 +463,18 @@ module Aws::WAFV2
462
463
  # of each rule. Simple rules that cost little to run use fewer WCUs than
463
464
  # more complex rules that use more processing power. Rule group capacity
464
465
  # is fixed at creation, which helps users plan their web ACL WCU usage
465
- # when they use a rule group. The WCU limit for web ACLs is 1,500.
466
+ # when they use a rule group. For more information, see [WAF web ACL
467
+ # capacity units (WCU)][1] in the *WAF Developer Guide*.
468
+ #
469
+ #
470
+ #
471
+ # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html
466
472
  #
467
473
  # @option params [required, String] :scope
468
474
  # Specifies whether this is for an Amazon CloudFront distribution or for
469
475
  # a regional application. A regional application can be an Application
470
476
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
471
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
477
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
472
478
  #
473
479
  # To work with CloudFront, you must also specify the Region US East (N.
474
480
  # Virginia) as follows:
@@ -1199,7 +1205,7 @@ module Aws::WAFV2
1199
1205
  # Specifies whether this is for an Amazon CloudFront distribution or for
1200
1206
  # a regional application. A regional application can be an Application
1201
1207
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
1202
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
1208
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
1203
1209
  #
1204
1210
  # To work with CloudFront, you must also specify the Region US East (N.
1205
1211
  # Virginia) as follows:
@@ -1309,7 +1315,7 @@ module Aws::WAFV2
1309
1315
  # Specifies whether this is for an Amazon CloudFront distribution or for
1310
1316
  # a regional application. A regional application can be an Application
1311
1317
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
1312
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
1318
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
1313
1319
  #
1314
1320
  # To work with CloudFront, you must also specify the Region US East (N.
1315
1321
  # Virginia) as follows:
@@ -1384,7 +1390,7 @@ module Aws::WAFV2
1384
1390
  # Specifies whether this is for an Amazon CloudFront distribution or for
1385
1391
  # a regional application. A regional application can be an Application
1386
1392
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
1387
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
1393
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
1388
1394
  #
1389
1395
  # To work with CloudFront, you must also specify the Region US East (N.
1390
1396
  # Virginia) as follows:
@@ -1408,7 +1414,12 @@ module Aws::WAFV2
1408
1414
  # of each rule. Simple rules that cost little to run use fewer WCUs than
1409
1415
  # more complex rules that use more processing power. Rule group capacity
1410
1416
  # is fixed at creation, which helps users plan their web ACL WCU usage
1411
- # when they use a rule group. The WCU limit for web ACLs is 1,500.
1417
+ # when they use a rule group. For more information, see [WAF web ACL
1418
+ # capacity units (WCU)][1] in the *WAF Developer Guide*.
1419
+ #
1420
+ #
1421
+ #
1422
+ # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html
1412
1423
  #
1413
1424
  # @option params [String] :description
1414
1425
  # A description of the rule group that helps with identification.
@@ -1433,18 +1444,17 @@ module Aws::WAFV2
1433
1444
  # rules that you define in the rule group.
1434
1445
  #
1435
1446
  # For information about customizing web requests and responses, see
1436
- # [Customizing web requests and responses in WAF][1] in the [WAF
1437
- # Developer Guide][2].
1447
+ # [Customizing web requests and responses in WAF][1] in the *WAF
1448
+ # Developer Guide*.
1438
1449
  #
1439
1450
  # For information about the limits on count and size for custom request
1440
- # and response settings, see [WAF quotas][3] in the [WAF Developer
1441
- # Guide][2].
1451
+ # and response settings, see [WAF quotas][2] in the *WAF Developer
1452
+ # Guide*.
1442
1453
  #
1443
1454
  #
1444
1455
  #
1445
1456
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
1446
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
1447
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1457
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
1448
1458
  #
1449
1459
  # @return [Types::CreateRuleGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1450
1460
  #
@@ -2184,7 +2194,7 @@ module Aws::WAFV2
2184
2194
  # can associate a web ACL with one or more Amazon Web Services resources
2185
2195
  # to protect. The resources can be an Amazon CloudFront distribution, an
2186
2196
  # Amazon API Gateway REST API, an Application Load Balancer, an AppSync
2187
- # GraphQL API, Amazon Cognito user pool, or an App Runner service.
2197
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
2188
2198
  #
2189
2199
  # @option params [required, String] :name
2190
2200
  # The name of the web ACL. You cannot change the name of a web ACL after
@@ -2194,7 +2204,7 @@ module Aws::WAFV2
2194
2204
  # Specifies whether this is for an Amazon CloudFront distribution or for
2195
2205
  # a regional application. A regional application can be an Application
2196
2206
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
2197
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
2207
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
2198
2208
  #
2199
2209
  # To work with CloudFront, you must also specify the Region US East (N.
2200
2210
  # Virginia) as follows:
@@ -2231,18 +2241,17 @@ module Aws::WAFV2
2231
2241
  # rules and default actions that you define in the web ACL.
2232
2242
  #
2233
2243
  # For information about customizing web requests and responses, see
2234
- # [Customizing web requests and responses in WAF][1] in the [WAF
2235
- # Developer Guide][2].
2244
+ # [Customizing web requests and responses in WAF][1] in the *WAF
2245
+ # Developer Guide*.
2236
2246
  #
2237
2247
  # For information about the limits on count and size for custom request
2238
- # and response settings, see [WAF quotas][3] in the [WAF Developer
2239
- # Guide][2].
2248
+ # and response settings, see [WAF quotas][2] in the *WAF Developer
2249
+ # Guide*.
2240
2250
  #
2241
2251
  #
2242
2252
  #
2243
2253
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
2244
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
2245
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
2254
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
2246
2255
  #
2247
2256
  # @option params [Types::CaptchaConfig] :captcha_config
2248
2257
  # Specifies how WAF should handle `CAPTCHA` evaluations for rules that
@@ -2270,6 +2279,24 @@ module Aws::WAFV2
2270
2279
  # Public suffixes aren't allowed. For example, you can't use `usa.gov`
2271
2280
  # or `co.uk` as token domains.
2272
2281
  #
2282
+ # @option params [Types::AssociationConfig] :association_config
2283
+ # Specifies custom configurations for the associations between the web
2284
+ # ACL and protected resources.
2285
+ #
2286
+ # Use this to customize the maximum size of the request body that your
2287
+ # protected CloudFront distributions forward to WAF for inspection. The
2288
+ # default is 16 KB (16,384 kilobytes).
2289
+ #
2290
+ # <note markdown="1"> You are charged additional fees when your protected resources forward
2291
+ # body sizes that are larger than the default. For more information, see
2292
+ # [WAF Pricing][1].
2293
+ #
2294
+ # </note>
2295
+ #
2296
+ #
2297
+ #
2298
+ # [1]: http://aws.amazon.com/waf/pricing/
2299
+ #
2273
2300
  # @return [Types::CreateWebACLResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2274
2301
  #
2275
2302
  # * {Types::CreateWebACLResponse#summary #summary} => Types::WebACLSummary
@@ -3012,6 +3039,13 @@ module Aws::WAFV2
3012
3039
  # },
3013
3040
  # },
3014
3041
  # token_domains: ["TokenDomain"],
3042
+ # association_config: {
3043
+ # request_body: {
3044
+ # "CLOUDFRONT" => {
3045
+ # default_size_inspection_limit: "KB_16", # required, accepts KB_16, KB_32, KB_48, KB_64
3046
+ # },
3047
+ # },
3048
+ # },
3015
3049
  # })
3016
3050
  #
3017
3051
  # @example Response structure
@@ -3084,7 +3118,7 @@ module Aws::WAFV2
3084
3118
  # Specifies whether this is for an Amazon CloudFront distribution or for
3085
3119
  # a regional application. A regional application can be an Application
3086
3120
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3087
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3121
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3088
3122
  #
3089
3123
  # To work with CloudFront, you must also specify the Region US East (N.
3090
3124
  # Virginia) as follows:
@@ -3189,7 +3223,7 @@ module Aws::WAFV2
3189
3223
  # Specifies whether this is for an Amazon CloudFront distribution or for
3190
3224
  # a regional application. A regional application can be an Application
3191
3225
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3192
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3226
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3193
3227
  #
3194
3228
  # To work with CloudFront, you must also specify the Region US East (N.
3195
3229
  # Virginia) as follows:
@@ -3244,7 +3278,7 @@ module Aws::WAFV2
3244
3278
  # Specifies whether this is for an Amazon CloudFront distribution or for
3245
3279
  # a regional application. A regional application can be an Application
3246
3280
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3247
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3281
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3248
3282
  #
3249
3283
  # To work with CloudFront, you must also specify the Region US East (N.
3250
3284
  # Virginia) as follows:
@@ -3303,7 +3337,8 @@ module Aws::WAFV2
3303
3337
  #
3304
3338
  # * For Amazon CloudFront distributions, use the CloudFront call
3305
3339
  # `ListDistributionsByWebACLId`. For information, see
3306
- # [ListDistributionsByWebACLId][1].
3340
+ # [ListDistributionsByWebACLId][1] in the *Amazon CloudFront API
3341
+ # Reference*.
3307
3342
  #
3308
3343
  # * To disassociate a resource from a web ACL, use the following calls:
3309
3344
  #
@@ -3311,7 +3346,7 @@ module Aws::WAFV2
3311
3346
  #
3312
3347
  # * For Amazon CloudFront distributions, provide an empty web ACL ID
3313
3348
  # in the CloudFront call `UpdateDistribution`. For information, see
3314
- # [UpdateDistribution][2].
3349
+ # [UpdateDistribution][2] in the *Amazon CloudFront API Reference*.
3315
3350
  #
3316
3351
  # </note>
3317
3352
  #
@@ -3328,7 +3363,7 @@ module Aws::WAFV2
3328
3363
  # Specifies whether this is for an Amazon CloudFront distribution or for
3329
3364
  # a regional application. A regional application can be an Application
3330
3365
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3331
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3366
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3332
3367
  #
3333
3368
  # To work with CloudFront, you must also specify the Region US East (N.
3334
3369
  # Virginia) as follows:
@@ -3388,7 +3423,7 @@ module Aws::WAFV2
3388
3423
  # Specifies whether this is for an Amazon CloudFront distribution or for
3389
3424
  # a regional application. A regional application can be an Application
3390
3425
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3391
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3426
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3392
3427
  #
3393
3428
  # To work with CloudFront, you must also specify the Region US East (N.
3394
3429
  # Virginia) as follows:
@@ -3465,12 +3500,13 @@ module Aws::WAFV2
3465
3500
  # existing web ACL association. A resource can have at most one web ACL
3466
3501
  # association. A regional application can be an Application Load
3467
3502
  # Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL
3468
- # API, a Amazon Cognito user pool, or an App Runner service.
3503
+ # API, an Amazon Cognito user pool, or an App Runner service.
3469
3504
  #
3470
3505
  # For Amazon CloudFront, don't use this call. Instead, use your
3471
3506
  # CloudFront distribution configuration. To disassociate a web ACL,
3472
3507
  # provide an empty web ACL ID in the CloudFront call
3473
- # `UpdateDistribution`. For information, see [UpdateDistribution][1].
3508
+ # `UpdateDistribution`. For information, see [UpdateDistribution][1] in
3509
+ # the *Amazon CloudFront API Reference*.
3474
3510
  #
3475
3511
  #
3476
3512
  #
@@ -3483,20 +3519,21 @@ module Aws::WAFV2
3483
3519
  # The ARN must be in one of the following formats:
3484
3520
  #
3485
3521
  # * For an Application Load Balancer:
3486
- # `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
3522
+ # `arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
3487
3523
  # `
3488
3524
  #
3489
3525
  # * For an Amazon API Gateway REST API:
3490
- # `arn:aws:apigateway:region::/restapis/api-id/stages/stage-name `
3526
+ # `arn:partition:apigateway:region::/restapis/api-id/stages/stage-name
3527
+ # `
3491
3528
  #
3492
3529
  # * For an AppSync GraphQL API:
3493
- # `arn:aws:appsync:region:account-id:apis/GraphQLApiId `
3530
+ # `arn:partition:appsync:region:account-id:apis/GraphQLApiId `
3494
3531
  #
3495
3532
  # * For an Amazon Cognito user pool:
3496
- # `arn:aws:cognito-idp:region:account-id:userpool/user-pool-id `
3533
+ # `arn:partition:cognito-idp:region:account-id:userpool/user-pool-id `
3497
3534
  #
3498
3535
  # * For an App Runner service:
3499
- # `arn:aws:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
3536
+ # `arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
3500
3537
  # `
3501
3538
  #
3502
3539
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -3570,7 +3607,7 @@ module Aws::WAFV2
3570
3607
  # Specifies whether this is for an Amazon CloudFront distribution or for
3571
3608
  # a regional application. A regional application can be an Application
3572
3609
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3573
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3610
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3574
3611
  #
3575
3612
  # To work with CloudFront, you must also specify the Region US East (N.
3576
3613
  # Virginia) as follows:
@@ -3702,7 +3739,7 @@ module Aws::WAFV2
3702
3739
  # Specifies whether this is for an Amazon CloudFront distribution or for
3703
3740
  # a regional application. A regional application can be an Application
3704
3741
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3705
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3742
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3706
3743
  #
3707
3744
  # To work with CloudFront, you must also specify the Region US East (N.
3708
3745
  # Virginia) as follows:
@@ -3859,7 +3896,7 @@ module Aws::WAFV2
3859
3896
  # Specifies whether this is for an Amazon CloudFront distribution or for
3860
3897
  # a regional application. A regional application can be an Application
3861
3898
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3862
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3899
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3863
3900
  #
3864
3901
  # To work with CloudFront, you must also specify the Region US East (N.
3865
3902
  # Virginia) as follows:
@@ -3932,7 +3969,7 @@ module Aws::WAFV2
3932
3969
  # Specifies whether this is for an Amazon CloudFront distribution or for
3933
3970
  # a regional application. A regional application can be an Application
3934
3971
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3935
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
3972
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3936
3973
  #
3937
3974
  # To work with CloudFront, you must also specify the Region US East (N.
3938
3975
  # Virginia) as follows:
@@ -3989,7 +4026,7 @@ module Aws::WAFV2
3989
4026
  # Specifies whether this is for an Amazon CloudFront distribution or for
3990
4027
  # a regional application. A regional application can be an Application
3991
4028
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
3992
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
4029
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
3993
4030
  #
3994
4031
  # To work with CloudFront, you must also specify the Region US East (N.
3995
4032
  # Virginia) as follows:
@@ -4345,7 +4382,7 @@ module Aws::WAFV2
4345
4382
  # Specifies whether this is for an Amazon CloudFront distribution or for
4346
4383
  # a regional application. A regional application can be an Application
4347
4384
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
4348
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
4385
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
4349
4386
  #
4350
4387
  # To work with CloudFront, you must also specify the Region US East (N.
4351
4388
  # Virginia) as follows:
@@ -4441,7 +4478,7 @@ module Aws::WAFV2
4441
4478
  # Specifies whether this is for an Amazon CloudFront distribution or for
4442
4479
  # a regional application. A regional application can be an Application
4443
4480
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
4444
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
4481
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
4445
4482
  #
4446
4483
  # To work with CloudFront, you must also specify the Region US East (N.
4447
4484
  # Virginia) as follows:
@@ -5309,6 +5346,8 @@ module Aws::WAFV2
5309
5346
  # resp.web_acl.challenge_config.immunity_time_property.immunity_time #=> Integer
5310
5347
  # resp.web_acl.token_domains #=> Array
5311
5348
  # resp.web_acl.token_domains[0] #=> String
5349
+ # resp.web_acl.association_config.request_body #=> Hash
5350
+ # resp.web_acl.association_config.request_body["AssociatedResourceType"].default_size_inspection_limit #=> String, one of "KB_16", "KB_32", "KB_48", "KB_64"
5312
5351
  # resp.lock_token #=> String
5313
5352
  # resp.application_integration_url #=> String
5314
5353
  #
@@ -5330,20 +5369,21 @@ module Aws::WAFV2
5330
5369
  # The ARN must be in one of the following formats:
5331
5370
  #
5332
5371
  # * For an Application Load Balancer:
5333
- # `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
5372
+ # `arn:partition:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
5334
5373
  # `
5335
5374
  #
5336
5375
  # * For an Amazon API Gateway REST API:
5337
- # `arn:aws:apigateway:region::/restapis/api-id/stages/stage-name `
5376
+ # `arn:partition:apigateway:region::/restapis/api-id/stages/stage-name
5377
+ # `
5338
5378
  #
5339
5379
  # * For an AppSync GraphQL API:
5340
- # `arn:aws:appsync:region:account-id:apis/GraphQLApiId `
5380
+ # `arn:partition:appsync:region:account-id:apis/GraphQLApiId `
5341
5381
  #
5342
5382
  # * For an Amazon Cognito user pool:
5343
- # `arn:aws:cognito-idp:region:account-id:userpool/user-pool-id `
5383
+ # `arn:partition:cognito-idp:region:account-id:userpool/user-pool-id `
5344
5384
  #
5345
5385
  # * For an App Runner service:
5346
- # `arn:aws:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
5386
+ # `arn:partition:apprunner:region:account-id:service/apprunner-service-name/apprunner-service-id
5347
5387
  # `
5348
5388
  #
5349
5389
  # @return [Types::GetWebACLForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -6195,6 +6235,8 @@ module Aws::WAFV2
6195
6235
  # resp.web_acl.challenge_config.immunity_time_property.immunity_time #=> Integer
6196
6236
  # resp.web_acl.token_domains #=> Array
6197
6237
  # resp.web_acl.token_domains[0] #=> String
6238
+ # resp.web_acl.association_config.request_body #=> Hash
6239
+ # resp.web_acl.association_config.request_body["AssociatedResourceType"].default_size_inspection_limit #=> String, one of "KB_16", "KB_32", "KB_48", "KB_64"
6198
6240
  #
6199
6241
  # @see http://docs.aws.amazon.com/goto/WebAPI/wafv2-2019-07-29/GetWebACLForResource AWS API Documentation
6200
6242
  #
@@ -6220,7 +6262,7 @@ module Aws::WAFV2
6220
6262
  # Specifies whether this is for an Amazon CloudFront distribution or for
6221
6263
  # a regional application. A regional application can be an Application
6222
6264
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6223
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6265
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6224
6266
  #
6225
6267
  # To work with CloudFront, you must also specify the Region US East (N.
6226
6268
  # Virginia) as follows:
@@ -6285,7 +6327,7 @@ module Aws::WAFV2
6285
6327
  # Specifies whether this is for an Amazon CloudFront distribution or for
6286
6328
  # a regional application. A regional application can be an Application
6287
6329
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6288
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6330
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6289
6331
  #
6290
6332
  # To work with CloudFront, you must also specify the Region US East (N.
6291
6333
  # Virginia) as follows:
@@ -6346,7 +6388,7 @@ module Aws::WAFV2
6346
6388
  # Specifies whether this is for an Amazon CloudFront distribution or for
6347
6389
  # a regional application. A regional application can be an Application
6348
6390
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6349
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6391
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6350
6392
  #
6351
6393
  # To work with CloudFront, you must also specify the Region US East (N.
6352
6394
  # Virginia) as follows:
@@ -6407,7 +6449,7 @@ module Aws::WAFV2
6407
6449
  # Specifies whether this is for an Amazon CloudFront distribution or for
6408
6450
  # a regional application. A regional application can be an Application
6409
6451
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6410
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6452
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6411
6453
  #
6412
6454
  # To work with CloudFront, you must also specify the Region US East (N.
6413
6455
  # Virginia) as follows:
@@ -6506,7 +6548,7 @@ module Aws::WAFV2
6506
6548
  # Specifies whether this is for an Amazon CloudFront distribution or for
6507
6549
  # a regional application. A regional application can be an Application
6508
6550
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6509
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6551
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6510
6552
  #
6511
6553
  # To work with CloudFront, you must also specify the Region US East (N.
6512
6554
  # Virginia) as follows:
@@ -6627,7 +6669,7 @@ module Aws::WAFV2
6627
6669
  # Specifies whether this is for an Amazon CloudFront distribution or for
6628
6670
  # a regional application. A regional application can be an Application
6629
6671
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6630
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6672
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6631
6673
  #
6632
6674
  # To work with CloudFront, you must also specify the Region US East (N.
6633
6675
  # Virginia) as follows:
@@ -6693,7 +6735,7 @@ module Aws::WAFV2
6693
6735
  # @option params [String] :resource_type
6694
6736
  # Used for web ACLs that are scoped for regional applications. A
6695
6737
  # regional application can be an Application Load Balancer (ALB), an
6696
- # Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito
6738
+ # Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito
6697
6739
  # user pool, or an App Runner service.
6698
6740
  #
6699
6741
  # <note markdown="1"> If you don't provide a resource type, the call uses the resource type
@@ -6735,7 +6777,7 @@ module Aws::WAFV2
6735
6777
  # Specifies whether this is for an Amazon CloudFront distribution or for
6736
6778
  # a regional application. A regional application can be an Application
6737
6779
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6738
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6780
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6739
6781
  #
6740
6782
  # To work with CloudFront, you must also specify the Region US East (N.
6741
6783
  # Virginia) as follows:
@@ -6854,7 +6896,7 @@ module Aws::WAFV2
6854
6896
  # Specifies whether this is for an Amazon CloudFront distribution or for
6855
6897
  # a regional application. A regional application can be an Application
6856
6898
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
6857
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
6899
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
6858
6900
  #
6859
6901
  # To work with CloudFront, you must also specify the Region US East (N.
6860
6902
  # Virginia) as follows:
@@ -7131,7 +7173,7 @@ module Aws::WAFV2
7131
7173
  # Specifies whether this is for an Amazon CloudFront distribution or for
7132
7174
  # a regional application. A regional application can be an Application
7133
7175
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
7134
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
7176
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
7135
7177
  #
7136
7178
  # To work with CloudFront, you must also specify the Region US East (N.
7137
7179
  # Virginia) as follows:
@@ -7221,8 +7263,7 @@ module Aws::WAFV2
7221
7263
  #
7222
7264
  # The policy specifications must conform to the following:
7223
7265
  #
7224
- # * The policy must be composed using IAM Policy version 2012-10-17 or
7225
- # version 2015-01-01.
7266
+ # * The policy must be composed using IAM Policy version 2012-10-17.
7226
7267
  #
7227
7268
  # * The policy must include specifications for `Effect`, `Action`, and
7228
7269
  # `Principal`.
@@ -7370,7 +7411,7 @@ module Aws::WAFV2
7370
7411
  # Specifies whether this is for an Amazon CloudFront distribution or for
7371
7412
  # a regional application. A regional application can be an Application
7372
7413
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
7373
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
7414
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
7374
7415
  #
7375
7416
  # To work with CloudFront, you must also specify the Region US East (N.
7376
7417
  # Virginia) as follows:
@@ -7495,7 +7536,7 @@ module Aws::WAFV2
7495
7536
  # Specifies whether this is for an Amazon CloudFront distribution or for
7496
7537
  # a regional application. A regional application can be an Application
7497
7538
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
7498
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
7539
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
7499
7540
  #
7500
7541
  # To work with CloudFront, you must also specify the Region US East (N.
7501
7542
  # Virginia) as follows:
@@ -7601,7 +7642,7 @@ module Aws::WAFV2
7601
7642
  # Specifies whether this is for an Amazon CloudFront distribution or for
7602
7643
  # a regional application. A regional application can be an Application
7603
7644
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
7604
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
7645
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
7605
7646
  #
7606
7647
  # To work with CloudFront, you must also specify the Region US East (N.
7607
7648
  # Virginia) as follows:
@@ -7707,7 +7748,7 @@ module Aws::WAFV2
7707
7748
  # Specifies whether this is for an Amazon CloudFront distribution or for
7708
7749
  # a regional application. A regional application can be an Application
7709
7750
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
7710
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
7751
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
7711
7752
  #
7712
7753
  # To work with CloudFront, you must also specify the Region US East (N.
7713
7754
  # Virginia) as follows:
@@ -7752,18 +7793,17 @@ module Aws::WAFV2
7752
7793
  # rules that you define in the rule group.
7753
7794
  #
7754
7795
  # For information about customizing web requests and responses, see
7755
- # [Customizing web requests and responses in WAF][1] in the [WAF
7756
- # Developer Guide][2].
7796
+ # [Customizing web requests and responses in WAF][1] in the *WAF
7797
+ # Developer Guide*.
7757
7798
  #
7758
7799
  # For information about the limits on count and size for custom request
7759
- # and response settings, see [WAF quotas][3] in the [WAF Developer
7760
- # Guide][2].
7800
+ # and response settings, see [WAF quotas][2] in the *WAF Developer
7801
+ # Guide*.
7761
7802
  #
7762
7803
  #
7763
7804
  #
7764
7805
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
7765
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
7766
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
7806
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
7767
7807
  #
7768
7808
  # @return [Types::UpdateRuleGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7769
7809
  #
@@ -8524,7 +8564,7 @@ module Aws::WAFV2
8524
8564
  # can associate a web ACL with one or more Amazon Web Services resources
8525
8565
  # to protect. The resources can be an Amazon CloudFront distribution, an
8526
8566
  # Amazon API Gateway REST API, an Application Load Balancer, an AppSync
8527
- # GraphQL API, Amazon Cognito user pool, or an App Runner service.
8567
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
8528
8568
  #
8529
8569
  # @option params [required, String] :name
8530
8570
  # The name of the web ACL. You cannot change the name of a web ACL after
@@ -8534,7 +8574,7 @@ module Aws::WAFV2
8534
8574
  # Specifies whether this is for an Amazon CloudFront distribution or for
8535
8575
  # a regional application. A regional application can be an Application
8536
8576
  # Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync
8537
- # GraphQL API, a Amazon Cognito user pool, or an App Runner service.
8577
+ # GraphQL API, an Amazon Cognito user pool, or an App Runner service.
8538
8578
  #
8539
8579
  # To work with CloudFront, you must also specify the Region US East (N.
8540
8580
  # Virginia) as follows:
@@ -8583,18 +8623,17 @@ module Aws::WAFV2
8583
8623
  # rules and default actions that you define in the web ACL.
8584
8624
  #
8585
8625
  # For information about customizing web requests and responses, see
8586
- # [Customizing web requests and responses in WAF][1] in the [WAF
8587
- # Developer Guide][2].
8626
+ # [Customizing web requests and responses in WAF][1] in the *WAF
8627
+ # Developer Guide*.
8588
8628
  #
8589
8629
  # For information about the limits on count and size for custom request
8590
- # and response settings, see [WAF quotas][3] in the [WAF Developer
8591
- # Guide][2].
8630
+ # and response settings, see [WAF quotas][2] in the *WAF Developer
8631
+ # Guide*.
8592
8632
  #
8593
8633
  #
8594
8634
  #
8595
8635
  # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html
8596
- # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html
8597
- # [3]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
8636
+ # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/limits.html
8598
8637
  #
8599
8638
  # @option params [Types::CaptchaConfig] :captcha_config
8600
8639
  # Specifies how WAF should handle `CAPTCHA` evaluations for rules that
@@ -8622,6 +8661,24 @@ module Aws::WAFV2
8622
8661
  # Public suffixes aren't allowed. For example, you can't use `usa.gov`
8623
8662
  # or `co.uk` as token domains.
8624
8663
  #
8664
+ # @option params [Types::AssociationConfig] :association_config
8665
+ # Specifies custom configurations for the associations between the web
8666
+ # ACL and protected resources.
8667
+ #
8668
+ # Use this to customize the maximum size of the request body that your
8669
+ # protected CloudFront distributions forward to WAF for inspection. The
8670
+ # default is 16 KB (16,384 kilobytes).
8671
+ #
8672
+ # <note markdown="1"> You are charged additional fees when your protected resources forward
8673
+ # body sizes that are larger than the default. For more information, see
8674
+ # [WAF Pricing][1].
8675
+ #
8676
+ # </note>
8677
+ #
8678
+ #
8679
+ #
8680
+ # [1]: http://aws.amazon.com/waf/pricing/
8681
+ #
8625
8682
  # @return [Types::UpdateWebACLResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8626
8683
  #
8627
8684
  # * {Types::UpdateWebACLResponse#next_lock_token #next_lock_token} => String
@@ -9360,6 +9417,13 @@ module Aws::WAFV2
9360
9417
  # },
9361
9418
  # },
9362
9419
  # token_domains: ["TokenDomain"],
9420
+ # association_config: {
9421
+ # request_body: {
9422
+ # "CLOUDFRONT" => {
9423
+ # default_size_inspection_limit: "KB_16", # required, accepts KB_16, KB_32, KB_48, KB_64
9424
+ # },
9425
+ # },
9426
+ # },
9363
9427
  # })
9364
9428
  #
9365
9429
  # @example Response structure
@@ -9388,7 +9452,7 @@ module Aws::WAFV2
9388
9452
  params: params,
9389
9453
  config: config)
9390
9454
  context[:gem_name] = 'aws-sdk-wafv2'
9391
- context[:gem_version] = '1.53.0'
9455
+ context[:gem_version] = '1.54.0'
9392
9456
  Seahorse::Client::Request.new(handlers, context)
9393
9457
  end
9394
9458