@aws-sdk/client-wafv2 3.309.0 → 3.311.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.
package/README.md CHANGED
@@ -39,7 +39,7 @@ Guide</a>.</p>
39
39
  <ul>
40
40
  <li>
41
41
  <p>For regional applications, you can use any of the endpoints in the list.
42
- A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service. </p>
42
+ A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
43
43
  </li>
44
44
  <li>
45
45
  <p>For Amazon CloudFront applications, you must use the API endpoint listed for
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.WAFInvalidPermissionPolicyException = exports.WAFServiceLinkedRoleErrorException = exports.WAFLogDestinationPermissionIssueException = exports.ResourceType = exports.FailureReason = exports.FilterRequirement = exports.FilterBehavior = exports.Platform = exports.WAFAssociatedItemException = exports.WAFConfigurationWarningException = exports.ResponseContentType = exports.WAFTagOperationInternalErrorException = exports.WAFTagOperationException = exports.WAFOptimisticLockException = exports.WAFDuplicateItemException = exports.IPAddressVersion = exports.WAFSubscriptionNotFoundException = exports.WAFLimitsExceededException = exports.WAFInvalidResourceException = exports.WAFExpiredManagedRuleGroupVersionException = exports.Scope = exports.WAFUnavailableEntityException = exports.WAFNonexistentItemException = exports.WAFInvalidParameterException = exports.ParameterExceptionField = exports.WAFInvalidOperationException = exports.WAFInternalErrorException = exports.SensitivityLevel = exports.ComparisonOperator = exports.RateBasedStatementAggregateKeyType = exports.InspectionLevel = exports.PayloadType = exports.LabelMatchScope = exports.ForwardedIPPosition = exports.FallbackBehavior = exports.CountryCode = exports.TextTransformationType = exports.PositionalConstraint = exports.JsonMatchScope = exports.BodyParsingFallbackBehavior = exports.MapMatchScope = exports.OversizeHandling = exports.ActionValue = void 0;
3
+ exports.WAFInvalidPermissionPolicyException = exports.WAFServiceLinkedRoleErrorException = exports.WAFLogDestinationPermissionIssueException = exports.ResourceType = exports.FailureReason = exports.FilterRequirement = exports.FilterBehavior = exports.Platform = exports.WAFAssociatedItemException = exports.WAFConfigurationWarningException = exports.ResponseContentType = exports.WAFTagOperationInternalErrorException = exports.WAFTagOperationException = exports.WAFOptimisticLockException = exports.WAFDuplicateItemException = exports.IPAddressVersion = exports.WAFSubscriptionNotFoundException = exports.WAFLimitsExceededException = exports.WAFInvalidResourceException = exports.WAFExpiredManagedRuleGroupVersionException = exports.Scope = exports.SizeInspectionLimit = exports.WAFUnavailableEntityException = exports.WAFNonexistentItemException = exports.WAFInvalidParameterException = exports.ParameterExceptionField = exports.WAFInvalidOperationException = exports.WAFInternalErrorException = exports.AssociatedResourceType = exports.SensitivityLevel = exports.ComparisonOperator = exports.RateBasedStatementAggregateKeyType = exports.InspectionLevel = exports.PayloadType = exports.LabelMatchScope = exports.ForwardedIPPosition = exports.FallbackBehavior = exports.CountryCode = exports.TextTransformationType = exports.PositionalConstraint = exports.JsonMatchScope = exports.BodyParsingFallbackBehavior = exports.MapMatchScope = exports.OversizeHandling = exports.ActionValue = void 0;
4
4
  const WAFV2ServiceException_1 = require("./WAFV2ServiceException");
5
5
  exports.ActionValue = {
6
6
  ALLOW: "ALLOW",
@@ -349,6 +349,9 @@ exports.SensitivityLevel = {
349
349
  HIGH: "HIGH",
350
350
  LOW: "LOW",
351
351
  };
352
+ exports.AssociatedResourceType = {
353
+ CLOUDFRONT: "CLOUDFRONT",
354
+ };
352
355
  class WAFInternalErrorException extends WAFV2ServiceException_1.WAFV2ServiceException {
353
356
  constructor(opts) {
354
357
  super({
@@ -380,6 +383,7 @@ exports.WAFInvalidOperationException = WAFInvalidOperationException;
380
383
  exports.ParameterExceptionField = {
381
384
  AND_STATEMENT: "AND_STATEMENT",
382
385
  ASSOCIABLE_RESOURCE: "ASSOCIABLE_RESOURCE",
386
+ ASSOCIATED_RESOURCE_TYPE: "ASSOCIATED_RESOURCE_TYPE",
383
387
  ATP_RULE_SET_RESPONSE_INSPECTION: "ATP_RULE_SET_RESPONSE_INSPECTION",
384
388
  BODY_PARSING_FALLBACK_BEHAVIOR: "BODY_PARSING_FALLBACK_BEHAVIOR",
385
389
  BYTE_MATCH_STATEMENT: "BYTE_MATCH_STATEMENT",
@@ -489,6 +493,12 @@ class WAFUnavailableEntityException extends WAFV2ServiceException_1.WAFV2Service
489
493
  }
490
494
  }
491
495
  exports.WAFUnavailableEntityException = WAFUnavailableEntityException;
496
+ exports.SizeInspectionLimit = {
497
+ KB_16: "KB_16",
498
+ KB_32: "KB_32",
499
+ KB_48: "KB_48",
500
+ KB_64: "KB_64",
501
+ };
492
502
  exports.Scope = {
493
503
  CLOUDFRONT: "CLOUDFRONT",
494
504
  REGIONAL: "REGIONAL",
@@ -2963,6 +2963,11 @@ const se_AssociateWebACLRequest = (input, context) => {
2963
2963
  ...(input.WebACLArn != null && { WebACLArn: input.WebACLArn }),
2964
2964
  };
2965
2965
  };
2966
+ const se_AssociationConfig = (input, context) => {
2967
+ return {
2968
+ ...(input.RequestBody != null && { RequestBody: se_RequestBody(input.RequestBody, context) }),
2969
+ };
2970
+ };
2966
2971
  const se_AWSManagedRulesATPRuleSet = (input, context) => {
2967
2972
  return {
2968
2973
  ...(input.LoginPath != null && { LoginPath: input.LoginPath }),
@@ -3120,6 +3125,9 @@ const se_CreateRuleGroupRequest = (input, context) => {
3120
3125
  };
3121
3126
  const se_CreateWebACLRequest = (input, context) => {
3122
3127
  return {
3128
+ ...(input.AssociationConfig != null && {
3129
+ AssociationConfig: se_AssociationConfig(input.AssociationConfig, context),
3130
+ }),
3123
3131
  ...(input.CaptchaConfig != null && { CaptchaConfig: se_CaptchaConfig(input.CaptchaConfig, context) }),
3124
3132
  ...(input.ChallengeConfig != null && { ChallengeConfig: se_ChallengeConfig(input.ChallengeConfig, context) }),
3125
3133
  ...(input.CustomResponseBodies != null && {
@@ -3713,6 +3721,20 @@ const se_RegularExpressionList = (input, context) => {
3713
3721
  return se_Regex(entry, context);
3714
3722
  });
3715
3723
  };
3724
+ const se_RequestBody = (input, context) => {
3725
+ return Object.entries(input).reduce((acc, [key, value]) => {
3726
+ if (value === null) {
3727
+ return acc;
3728
+ }
3729
+ acc[key] = se_RequestBodyAssociatedResourceTypeConfig(value, context);
3730
+ return acc;
3731
+ }, {});
3732
+ };
3733
+ const se_RequestBodyAssociatedResourceTypeConfig = (input, context) => {
3734
+ return {
3735
+ ...(input.DefaultSizeInspectionLimit != null && { DefaultSizeInspectionLimit: input.DefaultSizeInspectionLimit }),
3736
+ };
3737
+ };
3716
3738
  const se_RequestInspection = (input, context) => {
3717
3739
  return {
3718
3740
  ...(input.PasswordField != null && { PasswordField: se_PasswordField(input.PasswordField, context) }),
@@ -4062,6 +4084,9 @@ const se_UpdateRuleGroupRequest = (input, context) => {
4062
4084
  };
4063
4085
  const se_UpdateWebACLRequest = (input, context) => {
4064
4086
  return {
4087
+ ...(input.AssociationConfig != null && {
4088
+ AssociationConfig: se_AssociationConfig(input.AssociationConfig, context),
4089
+ }),
4065
4090
  ...(input.CaptchaConfig != null && { CaptchaConfig: se_CaptchaConfig(input.CaptchaConfig, context) }),
4066
4091
  ...(input.ChallengeConfig != null && { ChallengeConfig: se_ChallengeConfig(input.ChallengeConfig, context) }),
4067
4092
  ...(input.CustomResponseBodies != null && {
@@ -4142,6 +4167,11 @@ const de_AndStatement = (output, context) => {
4142
4167
  const de_AssociateWebACLResponse = (output, context) => {
4143
4168
  return {};
4144
4169
  };
4170
+ const de_AssociationConfig = (output, context) => {
4171
+ return {
4172
+ RequestBody: output.RequestBody != null ? de_RequestBody(output.RequestBody, context) : undefined,
4173
+ };
4174
+ };
4145
4175
  const de_AWSManagedRulesATPRuleSet = (output, context) => {
4146
4176
  return {
4147
4177
  LoginPath: (0, smithy_client_1.expectString)(output.LoginPath),
@@ -5122,6 +5152,20 @@ const de_ReleaseSummary = (output, context) => {
5122
5152
  Timestamp: output.Timestamp != null ? (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(output.Timestamp))) : undefined,
5123
5153
  };
5124
5154
  };
5155
+ const de_RequestBody = (output, context) => {
5156
+ return Object.entries(output).reduce((acc, [key, value]) => {
5157
+ if (value === null) {
5158
+ return acc;
5159
+ }
5160
+ acc[key] = de_RequestBodyAssociatedResourceTypeConfig(value, context);
5161
+ return acc;
5162
+ }, {});
5163
+ };
5164
+ const de_RequestBodyAssociatedResourceTypeConfig = (output, context) => {
5165
+ return {
5166
+ DefaultSizeInspectionLimit: (0, smithy_client_1.expectString)(output.DefaultSizeInspectionLimit),
5167
+ };
5168
+ };
5125
5169
  const de_RequestInspection = (output, context) => {
5126
5170
  return {
5127
5171
  PasswordField: output.PasswordField != null ? de_PasswordField(output.PasswordField, context) : undefined,
@@ -5677,6 +5721,7 @@ const de_WAFUnavailableEntityException = (output, context) => {
5677
5721
  const de_WebACL = (output, context) => {
5678
5722
  return {
5679
5723
  ARN: (0, smithy_client_1.expectString)(output.ARN),
5724
+ AssociationConfig: output.AssociationConfig != null ? de_AssociationConfig(output.AssociationConfig, context) : undefined,
5680
5725
  Capacity: (0, smithy_client_1.expectLong)(output.Capacity),
5681
5726
  CaptchaConfig: output.CaptchaConfig != null ? de_CaptchaConfig(output.CaptchaConfig, context) : undefined,
5682
5727
  ChallengeConfig: output.ChallengeConfig != null ? de_ChallengeConfig(output.ChallengeConfig, context) : undefined,
@@ -346,6 +346,9 @@ export const SensitivityLevel = {
346
346
  HIGH: "HIGH",
347
347
  LOW: "LOW",
348
348
  };
349
+ export const AssociatedResourceType = {
350
+ CLOUDFRONT: "CLOUDFRONT",
351
+ };
349
352
  export class WAFInternalErrorException extends __BaseException {
350
353
  constructor(opts) {
351
354
  super({
@@ -375,6 +378,7 @@ export class WAFInvalidOperationException extends __BaseException {
375
378
  export const ParameterExceptionField = {
376
379
  AND_STATEMENT: "AND_STATEMENT",
377
380
  ASSOCIABLE_RESOURCE: "ASSOCIABLE_RESOURCE",
381
+ ASSOCIATED_RESOURCE_TYPE: "ASSOCIATED_RESOURCE_TYPE",
378
382
  ATP_RULE_SET_RESPONSE_INSPECTION: "ATP_RULE_SET_RESPONSE_INSPECTION",
379
383
  BODY_PARSING_FALLBACK_BEHAVIOR: "BODY_PARSING_FALLBACK_BEHAVIOR",
380
384
  BYTE_MATCH_STATEMENT: "BYTE_MATCH_STATEMENT",
@@ -481,6 +485,12 @@ export class WAFUnavailableEntityException extends __BaseException {
481
485
  this.Message = opts.Message;
482
486
  }
483
487
  }
488
+ export const SizeInspectionLimit = {
489
+ KB_16: "KB_16",
490
+ KB_32: "KB_32",
491
+ KB_48: "KB_48",
492
+ KB_64: "KB_64",
493
+ };
484
494
  export const Scope = {
485
495
  CLOUDFRONT: "CLOUDFRONT",
486
496
  REGIONAL: "REGIONAL",
@@ -2863,6 +2863,11 @@ const se_AssociateWebACLRequest = (input, context) => {
2863
2863
  ...(input.WebACLArn != null && { WebACLArn: input.WebACLArn }),
2864
2864
  };
2865
2865
  };
2866
+ const se_AssociationConfig = (input, context) => {
2867
+ return {
2868
+ ...(input.RequestBody != null && { RequestBody: se_RequestBody(input.RequestBody, context) }),
2869
+ };
2870
+ };
2866
2871
  const se_AWSManagedRulesATPRuleSet = (input, context) => {
2867
2872
  return {
2868
2873
  ...(input.LoginPath != null && { LoginPath: input.LoginPath }),
@@ -3020,6 +3025,9 @@ const se_CreateRuleGroupRequest = (input, context) => {
3020
3025
  };
3021
3026
  const se_CreateWebACLRequest = (input, context) => {
3022
3027
  return {
3028
+ ...(input.AssociationConfig != null && {
3029
+ AssociationConfig: se_AssociationConfig(input.AssociationConfig, context),
3030
+ }),
3023
3031
  ...(input.CaptchaConfig != null && { CaptchaConfig: se_CaptchaConfig(input.CaptchaConfig, context) }),
3024
3032
  ...(input.ChallengeConfig != null && { ChallengeConfig: se_ChallengeConfig(input.ChallengeConfig, context) }),
3025
3033
  ...(input.CustomResponseBodies != null && {
@@ -3613,6 +3621,20 @@ const se_RegularExpressionList = (input, context) => {
3613
3621
  return se_Regex(entry, context);
3614
3622
  });
3615
3623
  };
3624
+ const se_RequestBody = (input, context) => {
3625
+ return Object.entries(input).reduce((acc, [key, value]) => {
3626
+ if (value === null) {
3627
+ return acc;
3628
+ }
3629
+ acc[key] = se_RequestBodyAssociatedResourceTypeConfig(value, context);
3630
+ return acc;
3631
+ }, {});
3632
+ };
3633
+ const se_RequestBodyAssociatedResourceTypeConfig = (input, context) => {
3634
+ return {
3635
+ ...(input.DefaultSizeInspectionLimit != null && { DefaultSizeInspectionLimit: input.DefaultSizeInspectionLimit }),
3636
+ };
3637
+ };
3616
3638
  const se_RequestInspection = (input, context) => {
3617
3639
  return {
3618
3640
  ...(input.PasswordField != null && { PasswordField: se_PasswordField(input.PasswordField, context) }),
@@ -3962,6 +3984,9 @@ const se_UpdateRuleGroupRequest = (input, context) => {
3962
3984
  };
3963
3985
  const se_UpdateWebACLRequest = (input, context) => {
3964
3986
  return {
3987
+ ...(input.AssociationConfig != null && {
3988
+ AssociationConfig: se_AssociationConfig(input.AssociationConfig, context),
3989
+ }),
3965
3990
  ...(input.CaptchaConfig != null && { CaptchaConfig: se_CaptchaConfig(input.CaptchaConfig, context) }),
3966
3991
  ...(input.ChallengeConfig != null && { ChallengeConfig: se_ChallengeConfig(input.ChallengeConfig, context) }),
3967
3992
  ...(input.CustomResponseBodies != null && {
@@ -4042,6 +4067,11 @@ const de_AndStatement = (output, context) => {
4042
4067
  const de_AssociateWebACLResponse = (output, context) => {
4043
4068
  return {};
4044
4069
  };
4070
+ const de_AssociationConfig = (output, context) => {
4071
+ return {
4072
+ RequestBody: output.RequestBody != null ? de_RequestBody(output.RequestBody, context) : undefined,
4073
+ };
4074
+ };
4045
4075
  const de_AWSManagedRulesATPRuleSet = (output, context) => {
4046
4076
  return {
4047
4077
  LoginPath: __expectString(output.LoginPath),
@@ -5022,6 +5052,20 @@ const de_ReleaseSummary = (output, context) => {
5022
5052
  Timestamp: output.Timestamp != null ? __expectNonNull(__parseEpochTimestamp(__expectNumber(output.Timestamp))) : undefined,
5023
5053
  };
5024
5054
  };
5055
+ const de_RequestBody = (output, context) => {
5056
+ return Object.entries(output).reduce((acc, [key, value]) => {
5057
+ if (value === null) {
5058
+ return acc;
5059
+ }
5060
+ acc[key] = de_RequestBodyAssociatedResourceTypeConfig(value, context);
5061
+ return acc;
5062
+ }, {});
5063
+ };
5064
+ const de_RequestBodyAssociatedResourceTypeConfig = (output, context) => {
5065
+ return {
5066
+ DefaultSizeInspectionLimit: __expectString(output.DefaultSizeInspectionLimit),
5067
+ };
5068
+ };
5025
5069
  const de_RequestInspection = (output, context) => {
5026
5070
  return {
5027
5071
  PasswordField: output.PasswordField != null ? de_PasswordField(output.PasswordField, context) : undefined,
@@ -5577,6 +5621,7 @@ const de_WAFUnavailableEntityException = (output, context) => {
5577
5621
  const de_WebACL = (output, context) => {
5578
5622
  return {
5579
5623
  ARN: __expectString(output.ARN),
5624
+ AssociationConfig: output.AssociationConfig != null ? de_AssociationConfig(output.AssociationConfig, context) : undefined,
5580
5625
  Capacity: __expectLong(output.Capacity),
5581
5626
  CaptchaConfig: output.CaptchaConfig != null ? de_CaptchaConfig(output.CaptchaConfig, context) : undefined,
5582
5627
  ChallengeConfig: output.ChallengeConfig != null ? de_ChallengeConfig(output.ChallengeConfig, context) : undefined,
@@ -79,7 +79,7 @@ import { WAFV2Client } from "./WAFV2Client";
79
79
  * <ul>
80
80
  * <li>
81
81
  * <p>For regional applications, you can use any of the endpoints in the list.
82
- * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service. </p>
82
+ * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
83
83
  * </li>
84
84
  * <li>
85
85
  * <p>For Amazon CloudFront applications, you must use the API endpoint listed for
@@ -113,10 +113,10 @@ export declare class WAFV2 extends WAFV2Client {
113
113
  /**
114
114
  * @public
115
115
  * <p>Associates a web ACL with a regional application resource, to protect the resource.
116
- * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service. </p>
116
+ * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
117
117
  * <p>For Amazon CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To
118
118
  * associate a web ACL, in the CloudFront call <code>UpdateDistribution</code>, set the web ACL ID
119
- * to the Amazon Resource Name (ARN) of the web ACL. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
119
+ * to the Amazon Resource Name (ARN) of the web ACL. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a> in the <i>Amazon CloudFront Developer Guide</i>. </p>
120
120
  * <p>When you make changes to web ACLs or web ACL components, like rules and rule groups, WAF propagates the changes everywhere that the web ACL and its components are stored and used. Your changes are applied within seconds, but there might be a brief period of inconsistency when the changes have arrived in some places and not in others. So, for example, if you change a rule action setting, the action might be the old action in one area and the new action in another area. Or if you add an IP address to an IP set used in a blocking rule, the new address might briefly be blocked in one area while still allowed in another. This temporary inconsistency can occur when you first associate a web ACL with an Amazon Web Services resource and when you change a web ACL that is already associated with a resource. Generally, any inconsistencies of this type last only a few seconds.</p>
121
121
  */
122
122
  associateWebACL(args: AssociateWebACLCommandInput, options?: __HttpHandlerOptions): Promise<AssociateWebACLCommandOutput>;
@@ -134,8 +134,8 @@ export declare class WAFV2 extends WAFV2Client {
134
134
  * Simple rules that cost little to run use fewer WCUs than more complex rules
135
135
  * that use more processing power.
136
136
  * Rule group capacity is fixed at creation, which helps users plan their
137
- * web ACL WCU usage when they use a rule group.
138
- * The WCU limit for web ACLs is 1,500. </p>
137
+ * web ACL WCU usage when they use a rule group. For more information, see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html">WAF web ACL capacity units (WCU)</a>
138
+ * in the <i>WAF Developer Guide</i>. </p>
139
139
  */
140
140
  checkCapacity(args: CheckCapacityCommandInput, options?: __HttpHandlerOptions): Promise<CheckCapacityCommandOutput>;
141
141
  checkCapacity(args: CheckCapacityCommandInput, cb: (err: any, data?: CheckCapacityCommandOutput) => void): void;
@@ -169,7 +169,7 @@ export declare class WAFV2 extends WAFV2Client {
169
169
  /**
170
170
  * @public
171
171
  * <p>Creates a <a>WebACL</a> per the specifications provided.</p>
172
- * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, Amazon Cognito user pool, or an App Runner service. </p>
172
+ * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
173
173
  */
174
174
  createWebACL(args: CreateWebACLCommandInput, options?: __HttpHandlerOptions): Promise<CreateWebACLCommandOutput>;
175
175
  createWebACL(args: CreateWebACLCommandInput, cb: (err: any, data?: CreateWebACLCommandOutput) => void): void;
@@ -236,7 +236,8 @@ export declare class WAFV2 extends WAFV2Client {
236
236
  * </li>
237
237
  * <li>
238
238
  * <p>For Amazon CloudFront distributions, use the CloudFront call
239
- * <code>ListDistributionsByWebACLId</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>.</p>
239
+ * <code>ListDistributionsByWebACLId</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>
240
+ * in the <i>Amazon CloudFront API Reference</i>. </p>
240
241
  * </li>
241
242
  * </ul>
242
243
  * </li>
@@ -248,7 +249,8 @@ export declare class WAFV2 extends WAFV2Client {
248
249
  * </li>
249
250
  * <li>
250
251
  * <p>For Amazon CloudFront distributions, provide an empty web ACL ID in the CloudFront call
251
- * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
252
+ * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>
253
+ * in the <i>Amazon CloudFront API Reference</i>. </p>
252
254
  * </li>
253
255
  * </ul>
254
256
  * </li>
@@ -269,10 +271,10 @@ export declare class WAFV2 extends WAFV2Client {
269
271
  /**
270
272
  * @public
271
273
  * <p>Disassociates the specified regional application resource from any existing web ACL
272
- * association. A resource can have at most one web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service. </p>
274
+ * association. A resource can have at most one web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
273
275
  * <p>For Amazon CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To
274
276
  * disassociate a web ACL, provide an empty web ACL ID in the CloudFront call
275
- * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
277
+ * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a> in the <i>Amazon CloudFront API Reference</i>. </p>
276
278
  */
277
279
  disassociateWebACL(args: DisassociateWebACLCommandInput, options?: __HttpHandlerOptions): Promise<DisassociateWebACLCommandOutput>;
278
280
  disassociateWebACL(args: DisassociateWebACLCommandInput, cb: (err: any, data?: DisassociateWebACLCommandOutput) => void): void;
@@ -713,7 +715,7 @@ export declare class WAFV2 extends WAFV2Client {
713
715
  * </ol>
714
716
  * </note>
715
717
  * <p>When you make changes to web ACLs or web ACL components, like rules and rule groups, WAF propagates the changes everywhere that the web ACL and its components are stored and used. Your changes are applied within seconds, but there might be a brief period of inconsistency when the changes have arrived in some places and not in others. So, for example, if you change a rule action setting, the action might be the old action in one area and the new action in another area. Or if you add an IP address to an IP set used in a blocking rule, the new address might briefly be blocked in one area while still allowed in another. This temporary inconsistency can occur when you first associate a web ACL with an Amazon Web Services resource and when you change a web ACL that is already associated with a resource. Generally, any inconsistencies of this type last only a few seconds.</p>
716
- * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, Amazon Cognito user pool, or an App Runner service. </p>
718
+ * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
717
719
  */
718
720
  updateWebACL(args: UpdateWebACLCommandInput, options?: __HttpHandlerOptions): Promise<UpdateWebACLCommandOutput>;
719
721
  updateWebACL(args: UpdateWebACLCommandInput, cb: (err: any, data?: UpdateWebACLCommandOutput) => void): void;
@@ -220,7 +220,7 @@ export interface WAFV2ClientResolvedConfig extends WAFV2ClientResolvedConfigType
220
220
  * <ul>
221
221
  * <li>
222
222
  * <p>For regional applications, you can use any of the endpoints in the list.
223
- * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service. </p>
223
+ * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
224
224
  * </li>
225
225
  * <li>
226
226
  * <p>For Amazon CloudFront applications, you must use the API endpoint listed for
@@ -20,10 +20,10 @@ export interface AssociateWebACLCommandOutput extends AssociateWebACLResponse, _
20
20
  /**
21
21
  * @public
22
22
  * <p>Associates a web ACL with a regional application resource, to protect the resource.
23
- * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service. </p>
23
+ * A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
24
24
  * <p>For Amazon CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To
25
25
  * associate a web ACL, in the CloudFront call <code>UpdateDistribution</code>, set the web ACL ID
26
- * to the Amazon Resource Name (ARN) of the web ACL. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
26
+ * to the Amazon Resource Name (ARN) of the web ACL. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a> in the <i>Amazon CloudFront Developer Guide</i>. </p>
27
27
  * <p>When you make changes to web ACLs or web ACL components, like rules and rule groups, WAF propagates the changes everywhere that the web ACL and its components are stored and used. Your changes are applied within seconds, but there might be a brief period of inconsistency when the changes have arrived in some places and not in others. So, for example, if you change a rule action setting, the action might be the old action in one area and the new action in another area. Or if you add an IP address to an IP set used in a blocking rule, the new address might briefly be blocked in one area while still allowed in another. This temporary inconsistency can occur when you first associate a web ACL with an Amazon Web Services resource and when you change a web ACL that is already associated with a resource. Generally, any inconsistencies of this type last only a few seconds.</p>
28
28
  * @example
29
29
  * Use a bare-bones client and the command you need to make an API call.
@@ -29,8 +29,8 @@ export interface CheckCapacityCommandOutput extends CheckCapacityResponse, __Met
29
29
  * Simple rules that cost little to run use fewer WCUs than more complex rules
30
30
  * that use more processing power.
31
31
  * Rule group capacity is fixed at creation, which helps users plan their
32
- * web ACL WCU usage when they use a rule group.
33
- * The WCU limit for web ACLs is 1,500. </p>
32
+ * web ACL WCU usage when they use a rule group. For more information, see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/aws-waf-capacity-units.html">WAF web ACL capacity units (WCU)</a>
33
+ * in the <i>WAF Developer Guide</i>. </p>
34
34
  * @example
35
35
  * Use a bare-bones client and the command you need to make an API call.
36
36
  * ```javascript
@@ -20,7 +20,7 @@ export interface CreateWebACLCommandOutput extends CreateWebACLResponse, __Metad
20
20
  /**
21
21
  * @public
22
22
  * <p>Creates a <a>WebACL</a> per the specifications provided.</p>
23
- * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, Amazon Cognito user pool, or an App Runner service. </p>
23
+ * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
24
24
  * @example
25
25
  * Use a bare-bones client and the command you need to make an API call.
26
26
  * ```javascript
@@ -786,6 +786,13 @@ export interface CreateWebACLCommandOutput extends CreateWebACLResponse, __Metad
786
786
  * TokenDomains: [ // TokenDomains
787
787
  * "STRING_VALUE",
788
788
  * ],
789
+ * AssociationConfig: { // AssociationConfig
790
+ * RequestBody: { // RequestBody
791
+ * "<keys>": { // RequestBodyAssociatedResourceTypeConfig
792
+ * DefaultSizeInspectionLimit: "KB_16" || "KB_32" || "KB_48" || "KB_64", // required
793
+ * },
794
+ * },
795
+ * },
789
796
  * };
790
797
  * const command = new CreateWebACLCommand(input);
791
798
  * const response = await client.send(command);
@@ -34,7 +34,8 @@ export interface DeleteWebACLCommandOutput extends DeleteWebACLResponse, __Metad
34
34
  * </li>
35
35
  * <li>
36
36
  * <p>For Amazon CloudFront distributions, use the CloudFront call
37
- * <code>ListDistributionsByWebACLId</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>.</p>
37
+ * <code>ListDistributionsByWebACLId</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>
38
+ * in the <i>Amazon CloudFront API Reference</i>. </p>
38
39
  * </li>
39
40
  * </ul>
40
41
  * </li>
@@ -46,7 +47,8 @@ export interface DeleteWebACLCommandOutput extends DeleteWebACLResponse, __Metad
46
47
  * </li>
47
48
  * <li>
48
49
  * <p>For Amazon CloudFront distributions, provide an empty web ACL ID in the CloudFront call
49
- * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
50
+ * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>
51
+ * in the <i>Amazon CloudFront API Reference</i>. </p>
50
52
  * </li>
51
53
  * </ul>
52
54
  * </li>
@@ -20,10 +20,10 @@ export interface DisassociateWebACLCommandOutput extends DisassociateWebACLRespo
20
20
  /**
21
21
  * @public
22
22
  * <p>Disassociates the specified regional application resource from any existing web ACL
23
- * association. A resource can have at most one web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, a Amazon Cognito user pool, or an App Runner service. </p>
23
+ * association. A resource can have at most one web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
24
24
  * <p>For Amazon CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To
25
25
  * disassociate a web ACL, provide an empty web ACL ID in the CloudFront call
26
- * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
26
+ * <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a> in the <i>Amazon CloudFront API Reference</i>. </p>
27
27
  * @example
28
28
  * Use a bare-bones client and the command you need to make an API call.
29
29
  * ```javascript
@@ -86,7 +86,7 @@ export interface PutPermissionPolicyCommandOutput extends PutPermissionPolicyRes
86
86
  * <p>The policy specifications must conform to the following:</p>
87
87
  * <ul>
88
88
  * <li>
89
- * <p>The policy must be composed using IAM Policy version 2012-10-17 or version 2015-01-01.</p>
89
+ * <p>The policy must be composed using IAM Policy version 2012-10-17.</p>
90
90
  * </li>
91
91
  * <li>
92
92
  * <p>The policy must include specifications for <code>Effect</code>, <code>Action</code>, and <code>Principal</code>.</p>
@@ -38,7 +38,7 @@ export interface UpdateWebACLCommandOutput extends UpdateWebACLResponse, __Metad
38
38
  * </ol>
39
39
  * </note>
40
40
  * <p>When you make changes to web ACLs or web ACL components, like rules and rule groups, WAF propagates the changes everywhere that the web ACL and its components are stored and used. Your changes are applied within seconds, but there might be a brief period of inconsistency when the changes have arrived in some places and not in others. So, for example, if you change a rule action setting, the action might be the old action in one area and the new action in another area. Or if you add an IP address to an IP set used in a blocking rule, the new address might briefly be blocked in one area while still allowed in another. This temporary inconsistency can occur when you first associate a web ACL with an Amazon Web Services resource and when you change a web ACL that is already associated with a resource. Generally, any inconsistencies of this type last only a few seconds.</p>
41
- * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, Amazon Cognito user pool, or an App Runner service. </p>
41
+ * <p> A web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a web ACL can be a combination of the types <a>Rule</a>, <a>RuleGroup</a>, and managed rule group. You can associate a web ACL with one or more Amazon Web Services resources to protect. The resources can be an Amazon CloudFront distribution, an Amazon API Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p>
42
42
  * @example
43
43
  * Use a bare-bones client and the command you need to make an API call.
44
44
  * ```javascript
@@ -800,6 +800,13 @@ export interface UpdateWebACLCommandOutput extends UpdateWebACLResponse, __Metad
800
800
  * TokenDomains: [ // TokenDomains
801
801
  * "STRING_VALUE",
802
802
  * ],
803
+ * AssociationConfig: { // AssociationConfig
804
+ * RequestBody: { // RequestBody
805
+ * "<keys>": { // RequestBodyAssociatedResourceTypeConfig
806
+ * DefaultSizeInspectionLimit: "KB_16" || "KB_32" || "KB_48" || "KB_64", // required
807
+ * },
808
+ * },
809
+ * },
803
810
  * };
804
811
  * const command = new UpdateWebACLCommand(input);
805
812
  * const response = await client.send(command);