Skip to content

Commit 23ab40d

Browse files
committed
Add warnings, tweaks to docs
1 parent 8ba0e3c commit 23ab40d

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

website/docs/r/wafv2_web_acl_rule_group_association.html.markdown

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,12 @@ This resource supports both:
1515
- **Custom Rule Groups**: User-created rule groups that you manage within your AWS account
1616
- **Managed Rule Groups**: Pre-configured rule groups provided by AWS or third-party vendors
1717

18-
~> **Note:** This resource creates a rule within the Web ACL that references the entire Rule Group. The rule group's individual rules are evaluated as a unit when requests are processed by the Web ACL.
18+
!> **Warning:** Verify the rule names in your `rule_action_override`s carefully. With managed rule groups, WAF silently ignores any override that uses an invalid rule name. With customer-owned rule groups, invalid rule names in your overrides will cause web ACL updates to fail. An invalid rule name is any name that doesn't exactly match the case-sensitive name of an existing rule in the rule group.
1919

2020
!> **Warning:** Using this resource will cause the associated Web ACL resource to show configuration drift in the `rule` argument unless you add `lifecycle { ignore_changes = [rule] }` to the Web ACL resource configuration. This is because this resource modifies the Web ACL's rules outside of the Web ACL resource's direct management.
2121

22+
~> **Note:** This resource creates a rule within the Web ACL that references the entire Rule Group. The rule group's individual rules are evaluated as a unit when requests are processed by the Web ACL.
23+
2224
## Example Usage
2325

2426
### Custom Rule Group - Basic Usage
@@ -402,7 +404,7 @@ The following arguments are optional:
402404

403405
### rule_action_override
404406

405-
* `name` - (Required) Name of the rule to override within the rule group.
407+
* `name` - (Required) Name of the rule to override within the rule group. Verify the name carefully. With managed rule groups, WAF silently ignores any override that uses an invalid rule name. With customer-owned rule groups, invalid rule names in your overrides will cause web ACL updates to fail. An invalid rule name is any name that doesn't exactly match the case-sensitive name of an existing rule in the rule group.
406408
* `action_to_use` - (Required) Action to use instead of the rule's original action. [See below](#action_to_use).
407409

408410
### action_to_use

0 commit comments

Comments
 (0)