Class WebACL

  • All Implemented Interfaces:
    Serializable, Cloneable

    public class WebACL
    extends Object
    implements Serializable, Cloneable

    Contains the Rules that identify the requests that you want to allow, block, or count. In a WebACL, you also specify a default action (ALLOW or BLOCK), and the action for each Rule that you add to a WebACL, for example, block requests from specified IP addresses or block requests from specified referrers. You also associate the WebACL with a CloudFront distribution to identify the requests that you want AWS WAF to filter. If you add more than one Rule to a WebACL, a request needs to match only one of the specifications to be allowed, blocked, or counted. For more information, see UpdateWebACL.

    See Also:
    Serialized Form
    • Constructor Detail

      • WebACL

        public WebACL()
    • Method Detail

      • withWebACLId

        public WebACL withWebACLId​(String webACLId)

        A unique identifier for a WebACL. You use WebACLId to get information about a WebACL (see GetWebACL), update a WebACL (see UpdateWebACL), and delete a WebACL from AWS WAF (see DeleteWebACL).

        WebACLId is returned by CreateWebACL and by ListWebACLs.

        Parameters:
        webACLId - A unique identifier for a WebACL. You use WebACLId to get information about a WebACL (see GetWebACL), update a WebACL (see UpdateWebACL), and delete a WebACL from AWS WAF (see DeleteWebACL).

        WebACLId is returned by CreateWebACL and by ListWebACLs.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
      • setName

        public void setName​(String name)

        A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.

        Parameters:
        name - A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.
      • getName

        public String getName()

        A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.

        Returns:
        A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.
      • withName

        public WebACL withName​(String name)

        A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.

        Parameters:
        name - A friendly name or description of the WebACL. You can't change the name of a WebACL after you create it.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
      • setMetricName

        public void setMetricName​(String metricName)
        Parameters:
        metricName -
      • getMetricName

        public String getMetricName()
        Returns:
      • withMetricName

        public WebACL withMetricName​(String metricName)
        Parameters:
        metricName -
        Returns:
        Returns a reference to this object so that method calls can be chained together.
      • setDefaultAction

        public void setDefaultAction​(WafAction defaultAction)

        The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.

        Parameters:
        defaultAction - The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.
      • getDefaultAction

        public WafAction getDefaultAction()

        The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.

        Returns:
        The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.
      • withDefaultAction

        public WebACL withDefaultAction​(WafAction defaultAction)

        The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.

        Parameters:
        defaultAction - The action to perform if none of the Rules contained in the WebACL match. The action is specified by the WafAction object.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
      • getRules

        public List<ActivatedRule> getRules()

        An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.

        Returns:
        An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.
      • setRules

        public void setRules​(Collection<ActivatedRule> rules)

        An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.

        Parameters:
        rules - An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.
      • withRules

        public WebACL withRules​(ActivatedRule... rules)

        An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.

        NOTE: This method appends the values to the existing list (if any). Use setRules(java.util.Collection) or withRules(java.util.Collection) if you want to override the existing values.

        Parameters:
        rules - An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.
        Returns:
        Returns a reference to this object so that method calls can be chained together.
      • withRules

        public WebACL withRules​(Collection<ActivatedRule> rules)

        An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.

        Parameters:
        rules - An array that contains the action for each Rule in a WebACL, the priority of the Rule, and the ID of the Rule.
        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; useful for testing and debugging.
        Overrides:
        toString in class Object
        Returns:
        A string representation of this object.
        See Also:
        Object.toString()
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object