paws.security.identity (version 0.1.0)

waf_delete_rate_based_rule: Permanently deletes a RateBasedRule

Description

Permanently deletes a RateBasedRule. You can't delete a rule if it's still used in any WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.

Usage

waf_delete_rate_based_rule(RuleId, ChangeToken)

Arguments

RuleId

[required] The RuleId of the RateBasedRule that you want to delete. RuleId is returned by CreateRateBasedRule and by ListRateBasedRules.

ChangeToken

[required] The value returned by the most recent call to GetChangeToken.

Request syntax

svc$delete_rate_based_rule(
  RuleId = "string",
  ChangeToken = "string"
)

Details

If you just want to remove a rule from a WebACL, use UpdateWebACL.

To permanently delete a RateBasedRule from AWS WAF, perform the following steps:

  1. Update the RateBasedRule to remove predicates, if any. For more information, see UpdateRateBasedRule.

  2. Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRateBasedRule request.

  3. Submit a DeleteRateBasedRule request.