AWS::WAFRegional::WebACLAssociation - AWS CloudFormation

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

Return values

Fn::GetAtt

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