AWS::WAFRegional::WebACLAssociation

Note

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.

The AWS::WAFRegional::WebACLAssociation resource associates an AWS WAF Regional web access control group (ACL) with a resource.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::WAFRegional::WebACLAssociation",
  "Properties" : {
      "ResourceArn" : String,
      "WebACLId" : String
    }
}

YAML

Type: AWS::WAFRegional::WebACLAssociation
Properties: 
  ResourceArn: String
  WebACLId: String

Properties

ResourceArn

The Amazon Resource Name (ARN) of the resource to protect with the web ACL.

Required: Yes

Type: String

Update requires: Replacement

WebACLId

A unique identifier (ID) for the web ACL.

Required: Yes

Type: String

Update requires: Replacement

Examples

Associate an Application Load Balancer resource with a web ACL

The following example associates an Application Load Balancer resource with a web ACL.

JSON

"MyWebACLAssociation": {
  "Type": "AWS::WAFRegional::WebACLAssociation",
  "Properties": {
    "ResourceArn": { "Ref": "MyLoadBalancer" },
    "WebACLId": { "Ref": "MyWebACL" }
  }
}

YAML

MyWebACLAssociation:
  Type: "AWS::WAFRegional::WebACLAssociation"
  Properties:
    ResourceArn:
      Ref: MyLoadBalancer
    WebACLId:
      Ref: MyWebACL