Rule (AWS SDK for Java

java.lang.Object
- com.amazonaws.services.wafv2.model.Rule

All Implemented Interfaces:

StructuredPojo, Serializable, Cloneable
```
@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class Rule
extends Object
implements Serializable, Cloneable, StructuredPojo
```
This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

A single rule, which you can use in a WebACL or RuleGroup to identify web requests that you want to allow, block, or count. Each rule includes one top-level Statement that AWS WAF uses to identify matching web requests, and parameters that govern how AWS WAF handles them.

See Also:

AWS API Documentation, Serialized Form

Constructor Summary

Constructors
Constructor and Description

Rule()

Constructors
Constructor and Description
`Rule()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Rule`	`clone()`
`boolean`	`equals(Object obj)`
`RuleAction`	`getAction()` The action that AWS WAF should take on a web request when it matches the rule's statement.
`String`	`getName()` A friendly name of the rule.
`OverrideAction`	`getOverrideAction()` The action to use to override the rule's `Action` setting.
`Integer`	`getPriority()` If you define more than one `Rule` in a `WebACL`, AWS WAF evaluates each request against the `Rules` in order based on the value of `Priority`.
`Statement`	`getStatement()` The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
`VisibilityConfig`	`getVisibilityConfig()` Defines and enables Amazon CloudWatch metrics and web request sample collection.
`int`	`hashCode()`
`void`	`marshall(ProtocolMarshaller protocolMarshaller)` Marshalls this structured data using the given `ProtocolMarshaller`.
`void`	`setAction(RuleAction action)` The action that AWS WAF should take on a web request when it matches the rule's statement.
`void`	`setName(String name)` A friendly name of the rule.
`void`	`setOverrideAction(OverrideAction overrideAction)` The action to use to override the rule's `Action` setting.
`void`	`setPriority(Integer priority)` If you define more than one `Rule` in a `WebACL`, AWS WAF evaluates each request against the `Rules` in order based on the value of `Priority`.
`void`	`setStatement(Statement statement)` The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
`void`	`setVisibilityConfig(VisibilityConfig visibilityConfig)` Defines and enables Amazon CloudWatch metrics and web request sample collection.
`String`	`toString()` Returns a string representation of this object.
`Rule`	`withAction(RuleAction action)` The action that AWS WAF should take on a web request when it matches the rule's statement.
`Rule`	`withName(String name)` A friendly name of the rule.
`Rule`	`withOverrideAction(OverrideAction overrideAction)` The action to use to override the rule's `Action` setting.
`Rule`	`withPriority(Integer priority)` If you define more than one `Rule` in a `WebACL`, AWS WAF evaluates each request against the `Rules` in order based on the value of `Priority`.
`Rule`	`withStatement(Statement statement)` The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
`Rule`	`withVisibilityConfig(VisibilityConfig visibilityConfig)` Defines and enables Amazon CloudWatch metrics and web request sample collection.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Rule
```
public Rule()
```
- Method Detail
  - setName
```
public void setName(String name)
```
    A friendly name of the rule. You can't change the name of a Rule after you create it.
    
    Parameters:
    
    name - A friendly name of the rule. You can't change the name of a Rule after you create it.
  - getName
```
public String getName()
```
    A friendly name of the rule. You can't change the name of a Rule after you create it.
    
    Returns:
    
    A friendly name of the rule. You can't change the name of a Rule after you create it.
  - withName
```
public Rule withName(String name)
```
    A friendly name of the rule. You can't change the name of a Rule after you create it.
    
    Parameters:
    
    name - A friendly name of the rule. You can't change the name of a Rule after you create it.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setPriority
```
public void setPriority(Integer priority)
```
    If you define more than one Rule in a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. AWS WAF processes rules with lower priority first. The priorities don't need to be consecutive, but they must all be different.
    
    Parameters:
    
    priority - If you define more than one Rule in a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. AWS WAF processes rules with lower priority first. The priorities don't need to be consecutive, but they must all be different.
  - getPriority
```
public Integer getPriority()
```
    If you define more than one Rule in a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. AWS WAF processes rules with lower priority first. The priorities don't need to be consecutive, but they must all be different.
    
    Returns:
    
    If you define more than one Rule in a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. AWS WAF processes rules with lower priority first. The priorities don't need to be consecutive, but they must all be different.
  - withPriority
```
public Rule withPriority(Integer priority)
```
    If you define more than one Rule in a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. AWS WAF processes rules with lower priority first. The priorities don't need to be consecutive, but they must all be different.
    
    Parameters:
    
    priority - If you define more than one Rule in a WebACL, AWS WAF evaluates each request against the Rules in order based on the value of Priority. AWS WAF processes rules with lower priority first. The priorities don't need to be consecutive, but they must all be different.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setStatement
```
public void setStatement(Statement statement)
```
    The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
    
    Parameters:
    
    statement - The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
  - getStatement
```
public Statement getStatement()
```
    The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
    
    Returns:
    
    The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
  - withStatement
```
public Rule withStatement(Statement statement)
```
    The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
    
    Parameters:
    
    statement - The AWS WAF processing statement for the rule, for example ByteMatchStatement or SizeConstraintStatement.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setAction
```
public void setAction(RuleAction action)
```
    The action that AWS WAF should take on a web request when it matches the rule's statement. Settings at the web ACL level can override the rule action setting.
    
    Parameters:
    
    action - The action that AWS WAF should take on a web request when it matches the rule's statement. Settings at the web ACL level can override the rule action setting.
  - getAction
```
public RuleAction getAction()
```
    The action that AWS WAF should take on a web request when it matches the rule's statement. Settings at the web ACL level can override the rule action setting.
    
    Returns:
    
    The action that AWS WAF should take on a web request when it matches the rule's statement. Settings at the web ACL level can override the rule action setting.
  - withAction
```
public Rule withAction(RuleAction action)
```
    The action that AWS WAF should take on a web request when it matches the rule's statement. Settings at the web ACL level can override the rule action setting.
    
    Parameters:
    
    action - The action that AWS WAF should take on a web request when it matches the rule's statement. Settings at the web ACL level can override the rule action setting.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setOverrideAction
```
public void setOverrideAction(OverrideAction overrideAction)
```
    The action to use to override the rule's Action setting. You can use no override action, in which case the rule action is in effect, or count action, in which case, if the rule matches a web request, it only counts the match.
    
    Parameters:
    
    overrideAction - The action to use to override the rule's Action setting. You can use no override action, in which case the rule action is in effect, or count action, in which case, if the rule matches a web request, it only counts the match.
  - getOverrideAction
```
public OverrideAction getOverrideAction()
```
    The action to use to override the rule's Action setting. You can use no override action, in which case the rule action is in effect, or count action, in which case, if the rule matches a web request, it only counts the match.
    
    Returns:
    
    The action to use to override the rule's Action setting. You can use no override action, in which case the rule action is in effect, or count action, in which case, if the rule matches a web request, it only counts the match.
  - withOverrideAction
```
public Rule withOverrideAction(OverrideAction overrideAction)
```
    The action to use to override the rule's Action setting. You can use no override action, in which case the rule action is in effect, or count action, in which case, if the rule matches a web request, it only counts the match.
    
    Parameters:
    
    overrideAction - The action to use to override the rule's Action setting. You can use no override action, in which case the rule action is in effect, or count action, in which case, if the rule matches a web request, it only counts the match.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - setVisibilityConfig
```
public void setVisibilityConfig(VisibilityConfig visibilityConfig)
```
    Defines and enables Amazon CloudWatch metrics and web request sample collection.
    
    Parameters:
    
    visibilityConfig - Defines and enables Amazon CloudWatch metrics and web request sample collection.
  - getVisibilityConfig
```
public VisibilityConfig getVisibilityConfig()
```
    Defines and enables Amazon CloudWatch metrics and web request sample collection.
    
    Returns:
    
    Defines and enables Amazon CloudWatch metrics and web request sample collection.
  - withVisibilityConfig
```
public Rule withVisibilityConfig(VisibilityConfig visibilityConfig)
```
    Defines and enables Amazon CloudWatch metrics and web request sample collection.
    
    Parameters:
    
    visibilityConfig - Defines and enables Amazon CloudWatch metrics and web request sample collection.
    
    Returns:
    
    Returns a reference to this object so that method calls can be chained together.
  - toString
```
public String toString()
```
    Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    A string representation of this object.
    
    See Also:
    
    Object.toString()
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - clone
```
public Rule clone()
```
    Overrides:
    
    clone in class Object
  - marshall
```
public void marshall(ProtocolMarshaller protocolMarshaller)
```
    Description copied from interface: StructuredPojo
    
    Marshalls this structured data using the given ProtocolMarshaller.
    
    Specified by:
    
    marshall in interface StructuredPojo
    
    Parameters:
    
    protocolMarshaller - Implementation of ProtocolMarshaller used to marshall this object's data.

Did this page help you?

Class Rule

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Rule

Method Detail

setName

getName

withName

setPriority

getPriority

withPriority

setStatement

getStatement

withStatement

setAction

getAction

withAction

setOverrideAction

getOverrideAction

withOverrideAction

setVisibilityConfig

getVisibilityConfig

withVisibilityConfig

toString

equals

hashCode

clone

marshall