Update Rule Group
waf_update_rule_group | R Documentation |
This is AWS WAF Classic documentation¶
Description¶
This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide.
For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.
Inserts or deletes ActivatedRule objects in a RuleGroup
.
You can only insert REGULAR
rules into a rule group.
You can have a maximum of ten rules per rule group.
To create and configure a RuleGroup
, perform the following steps:
-
Create and update the
Rules
that you want to include in theRuleGroup
. Seecreate_rule
. -
Use
get_change_token
to get the change token that you provide in theChangeToken
parameter of anupdate_rule_group
request. -
Submit an
update_rule_group
request to addRules
to theRuleGroup
. -
Create and update a
WebACL
that contains theRuleGroup
. Seecreate_web_acl
.
If you want to replace one Rule
with another, you delete the existing
one and add the new one.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
Usage¶
Arguments¶
RuleGroupId
[required] The
RuleGroupId
of the RuleGroup that you want to update.RuleGroupId
is returned bycreate_rule_group
and bylist_rule_groups
.Updates
[required] An array of
RuleGroupUpdate
objects that you want to insert into or delete from a RuleGroup.You can only insert
REGULAR
rules into a rule group.ActivatedRule|OverrideAction
applies only when updating or adding aRuleGroup
to aWebACL
. In this case you do not useActivatedRule|Action
. For all other update requests,ActivatedRule|Action
is used instead ofActivatedRule|OverrideAction
.ChangeToken
[required] The value returned by the most recent call to
get_change_token
.
Value¶
A list with the following syntax:
Request syntax¶
svc$update_rule_group(
RuleGroupId = "string",
Updates = list(
list(
Action = "INSERT"|"DELETE",
ActivatedRule = list(
Priority = 123,
RuleId = "string",
Action = list(
Type = "BLOCK"|"ALLOW"|"COUNT"
),
OverrideAction = list(
Type = "NONE"|"COUNT"
),
Type = "REGULAR"|"RATE_BASED"|"GROUP",
ExcludedRules = list(
list(
RuleId = "string"
)
)
)
)
),
ChangeToken = "string"
)